5 : 


NS 
SNUG 


SS 
SS 


Spring 技术 图 书 ， 针 对 Spring 4 全 新 升级 


了 

5 
[ 门 
I 
种 
内 
外 
发 
是 
声 
浪 
j 
比 
经 
= 
三 
光 
这 
党 
种 


阿 中 国 工作 出 版 集团 ”器 人 GO 


畅销 经 典 





译 


[ 美 ] Craig Walls 著 


张 卫 滨 





FOURTH EDITION 


(第 4 版 ) 
Spr 





第 1 章 下 Spring 之 旅 
11 简 和 化 了 ava 开 发 





订 g 以 3 
1.3.1 Sp jyring 模 二 
1.3.2 pe Ui 
























































版 权 信息 


书 名 : Spring 实 战 〈( 第 4 版 ) 
ISBN: 978-7-115-41730-5 
本 书 由 人 民 邮 电 出 版 社 发 行 数字 版 。 版 权 所 有 ， 侵 权 必 完 。 





您 购买 的 人 民 邮 电 出 版 社 电子 书 仅 供 您 个 人 使 用 ， 未 经 授权 ， 不 得 以 任 
何方 式 复制 和 传播 本 书 内 容 。 


我 们 愿意 相信 读者 具有 这 样 的 恨 知 和 觉悟 ， 与 我 们 共同 保护 知识 产权 。 


如 果 购 买 者 有 侵权 行为 ， 我 们 可 能 对 该 用 户 实施 包括 但 不 限于 关闭 该 帐 
写 等 维权 措施 ， 并 可 能 退 完 法 律 责任 。 

















著 [ 美 ] Craig Walls 

译 张 卫 滨 

责任 编辑 ” 陈 蔓 康 

人 民 邮 电 出 版 社 出 版 发 行 ” ”北京 市 丰台 区 成 寿 寺 路 11 号 
邮编 100164 ”电子 邮件 315@ptpress.com.cn 


< 


网 址 http://www.ptpress.com.cn 
读者 服务 热线 : (010)81055410 


反 盗 版 热线 : (010)81055315 


作者 简介 


Craig Walls 是 Pivotal 的 高 级 工程 师 ， 是 Spring Social 和 Spring Sync 的 项 目 
领导 者 ， 同 时 也 是 Manning 出 版 社 《Spring In Action》 的 作者 ， 目 前 这 
本 书 已 经 更 新 到 了 第 四 成 。 他 非常 热心 于 Spring 框架 的 推广 ， 经 党 在 当 
地 的 用 户 组 和 会 议 上 演讲 并 在 博客 上 撰写 Spring 相 关 的 内 容 。 在 不 琢磨 
代码 的 时 候 ，Craig Walls 会 尽 可 能 多 地 陪伴 他 的 妻子 、 两 个 女儿 、 两 只 
小 鸟 以 及 两 只 小 狗 。 


本 书 特色 

全 球 有 超过 100 000 的 开发 者 使 用 本 书 来 学 习 Spring 

0 畅销 经 典 Spring 技术 图 书 ， 针 对 Spring 4 全 
新 升级 





作者 Craig Walls，SpringSource 的 软件 开发 人 员 ， 也 是 一 位 畅销 书 作 
和 


第 3 版 译 者 继续 翻译 新 版 ， 品 质保 障 ! 


版权 声明 


Original English language edition, entitled Spring in Action,4th Edition by 
Craig Walls Bibeault published by Manning Publications Co., 209 Bruce 
Park Avenue, Greenwich, CT 06830. Copyright ©2015 by Manning 
Publications Co. 


Simplified Chinese-language edition copyright ©2016 by Posts & Telecom 
Press. All rights reserved. 


本 书 中 文 简体 字 版 由 Manning Publications Co. 授 权 人 民 邮 电 出 版 社 独 
家 出 版 。 未 经 出 版 者 书面 许可 ， 不 得 以 任何 方式 复制 本 书 内 容 。 


版 权 所 有 ， 侵 权 必 完 。 











we 4 HE 
内 容 所 要 
本 书 是 经 典 的 、 畅 销 的 Spring 学 习 和 实践 指南 。 


第 4 版 针对 Spring 4 进行 了 全 面 更 新 。 全 书 分 为 4 部 分 。 第 1 部 分 介绍 
Spring 框架 的 核心 知识 。 第 2 部 分 在 此 基础 上 介绍 了 如 何 使 用 Spring 构建 
Web 应 用 程序 。 第 3 部 分 告别 前 端 ， 介 绍 了 如 何在 应 用 程序 的 后 端 使 用 
Spring。 第 4 部 分 描述 了 如 何 使 用 Spring 与 其 他 的 应 用 和 服务 进行 集成 。 


本 书 适 用 于 已 具有 一 定 Java 编程 基础 的 读者 ， 以 及 在 Java 平台 下 进行 各 
类 软件 开发 的 开发 人 员 、 测 试 人 员 ， 尤 其 适用 于 企业 级 Java 开发 人 员 。 
本 书 既 可 以 被 刚 开 始 学 习 Spring 的 读者 当 作 学 习 指南 ， 也 可 以 被 那些 想 
深入 了 解 Spring 某 方面 功能 的 资深 用 户 作为 参考 用 书 。 





Spring 框架 是 以 简化 Java EE 应 用 程序 的 开发 为 目标 而 创建 的 。 同 样 ， 本 
书 是 为 了 帮助 读者 更 容易 地 使 用 Spring 而 编写 的 。 我 的 目标 不 是 为 读者 
详细 地 列 出 Spring API， 而 是 和 希望 通过 现实 中 的 实际 示例 代码 来 为 Java 

EE 开发 人 员 展 现 Spring 框 架 。 因 为 Spring 是 一 个 模块 化 的 框架 ， 所 以 这 
本 书 也 是 按照 这 种 方式 编写 的 。 我 们 知道 并 不 是 所 有 的 开发 人 员 都 有 相 
同 的 需求 ， 有 些 人 想 从 头 学 习 Spring， 而 有 的 可 能 只 想 排出 几 个 主题 ， 

然后 按照 自己 的 节奏 来 学 习 。 所 以 ， 本 书 既 可 以 被 刚 开 始 学 习 Spring 的 
J 也 可 以 被 那些 想 深 入 了 解 某 方面 功能 的 读者 作为 参 

















本 书 适 用 于 所 有 的 Java 开 发 人 员 ， 企 业 级 Java 开 发 人 员 将 会 发 现 更 用 
助 。 我 将 会 循序 渐进 地 指导 读者 浏览 本 书 中 每 章 复 杂 的 示例 代码 ， 但 
Spring 的 真正 强大 之 处 在 于 它 能 够 使 企业 级 应 用 程序 的 开发 更 简单 。 因 
此 ， 企 业 级 应 用 程序 的 开发 人 员 会 更 加 欣赏 本 书 的 示例 代码 。 因 为 
Spring 的 绝 大 部 分 内 容 都 是 提供 企业 级 服务 的 ， 所 以 这 里 包含 了 许多 
Spring 和 EJB 的 比较 。 














路 线 图 


本 书 分 为 4 部 分 。 第 1 部 分 介绍 Spring 框架 的 核心 知识 。 第 2 部 分 在 此 基础 
上 介绍 如 何 使 用 Spring 构建 Web 应 用 程序 。 第 3 部 分 告别 前 端 ， 介 绍 如 何 
在 应 用 程序 的 后 端 使 用 Spring。 第 4 部 分 描述 如 何 使 用 Spring 与 其 他 的 应 
用 和 服务 进行 集成 。 


在 第 1 部 分 中 ， 读 者 将 会 学 习 到 Spring 容器 、 依 赖 注 入 〈dependency 
injection，DI) 和 面 癌 切面 编程 〈aspect-oriented programming， 

AOP) ， 也 就 是 Spring 框架 的 核心 。 这 能 让 读者 很 好 地 理解 Spring 的 基 
础 原理 ， 而 这 些 原理 将 会 在 本 书 各 个 章节 都 会 用 到 。 


第 1 章 将 会 概要 地 介绍 Spring， 包 括 DI 和 AOP 的 一 些 基 本 样 例 。 同 
时 ， 读 者 还 会 了 解 到 更 大 的 Spring 生态 系统 的 整体 情况 。 

第 2 章 更 为 详细 地 介绍 DI， 展 现 应 用 程序 中 的 各 个 组 件 〈bean) 如 
何 装配 在 一 起 。 这 包括 基于 XML 装配 、 基 于 Java 装 配 以 及 自动 装 
配 。 

在 掌握 了 基本 的 bean 装 配 后 ， 第 3 章 会 介绍 几 种 高 级 装配 技术 ， 读 
者 可 能 并 不 会 经 常用 到 这 些 技术 ， 但 是 如 果 用 到 的 话 ， 本 章 的 内 容 
将 会 告诉 读者 如 何 发 挥 Spring 容器 最 强大 的 威力 。 

。 第 4 章 介 绍 如 何 使 用 Spring 的 AOP 来 为 对 象 解 耦 那些 对 其 提供 服务 的 
横 切 性 关注 点 。 这 一 章 也 为 后 面 各 章 提 供 基 础 ， 在 后 面 读者 将 会 使 
用 AOP 来 提供 声明 式 服 务 ， 如 事务 、 安 全 和 缓存 。 


在 第 2 部 分 中 ， 读 者 将 会 看 到 如 何 使 用 Spring 来 构建 Web 应 用 程序 。 


第 5 章 介 绍 使 用 Spring MVC 的 基础 知识 ， 这 是 Spring 中 的 基础 Web 
框架 。 读 者 将 会 看 到 如 何 编写 控制 器 来 处 理 请 求 ， 并 使 用 模型 数据 
产生 啊 应 。 

当 控 制 器 的 工作 完成 后 ， 模 型 数据 必须 要 使 用 一 个 视图 来 进行 泻 
染 。 第 6 章 将 会 探讨 在 Spring 中 可 以 使 用 的 各 种 视图 技术 ， 包 括 
JSP、Apache Tiles 以 及 Thymeleaf。 

第 7 章 的 内 容 不 再 是 Spring MVC 的 基础 知识 了 ， 在 本 章 中 ， 读 者 将 
会 学 习 到 如 何 自 定义 Spring MVC 配 置 、 处 理 multipart 类 型 的 文件 上 
传 、 处 理 在 控制 器 中 可 能 会 出 现 的 异常 并 且 会 通过 flash 属 性 在 请 求 
之 间 传 递 数据 。 























第 8 章 将 会 介绍 Spring Web Flow， 这 是 Spring MVC 的 一 个 扩展 ， 能 
够 开发 会 话 式 的 Web 应 用 程序 。 在 本 章 中 ， 读 者 将 会 学 习 到 如 何 构 
建 引导 用 户 完 成 特定 流程 的 Web 应 用 程序 。 

第 9 章 读 者 将 会 学 到 如 何 使 用 Spring Security 为 自己 的 应 用 程序 Web 
层 实现 安全 性 。 








第 3 部 分 所 关注 的 内 容 不 再 是 应 用 程序 的 前 端 了 ， 而 是 关注 于 如 何 处 理 
和 持久 化 数据 。 


第 10 章 首先 会 介绍 如 何 使 用 Spring 对 JDBC 的 抽象 实现 关系 型 数据 库 
中 的 数据 持久 化 。 

第 11 章 从 另外 一 个 角度 介绍 数据 持久 化 ， 也 就 是 使 用 Java 持 久 化 
API (JPA) 存储 关系 型 数据 库 中 的 数据 。 

第 12 章 将 会 介绍 如 何 将 Spring 与 非 关 系 型 数据 库 结 合 使 用 ， 如 
MongoDB 和 Neo4j 。 

不 管 数据 存储 在 什么 地 方 ， 缓 存 都 有 助 于 性 能 的 提升 ， 这 是 通过 只 
有 在 必要 的 时 候 才 去 查询 数据 库 实 现 的 。 第 13 章 将 会 为 读者 介绍 
Spring 对 声明 式 绥 存 的 文 持 。 

第 14 章 重新 回 到 Spring Security， 将 会 介绍 如 何 通 过 AOP 将 安全 性 
应 用 到 方法 级 别 。 











本 书 的 最 后 一 部 分 会 介绍 如 何 将 Spring 应 用 程序 与 其 他 系统 进行 集成 。 


第 15 章 将 会 学 习 如 何 创建 与 使 用 远程 服务 ， 包 括 RMI、Hessian、 

Burlap 以 及 基于 SOAP 的 服务 。 

第 16 章 将 会 再 次 回 到 Spring MVC， 我 们 将 会 看 到 如 何 创 建 RESTful 

服务 0 中 所 使 用 的 编程 模型 与 之 前 在 第 5 章 中 所 描述 的 

十 一 致 的 。 

第 17 章 将 会 探讨 Spring 对 异步 消息 的 文 持 ， 本 章 将 会 包括 Java 消 息 

服务 (Java Message Service，JMS) 以 及 高 级 消息 队列 协议 
(Advanced Message Queuing Protocol, AMQP) 。 

在 第 18 章 中 ， 有 异步 消 轧 有 了 新 的 花样 ， 在 这 一 章 中 读者 会 看 到 如 何 

将 Spring 与 WebSocket 和 STOMP 结 合 起 来 ， 实 现 服务 端 与 客户 端 之 
间 的 异步 通信 。 














。 第 19 章 将 会 介绍 如 何 使 用 Spring 发 送 E-mail。 


第 20 章 会 关注 于 Spring 对 Java 管 理 扩 展 (Java Management 
Extensions，JMX) 功能 的 支持 ， 借 助 这 项 功能 可 以 对 Spring 应 用 程 
序 进 行 监控 和 修改 运行 时 配置 。 








。 最 后 ， 在 第 21 章 ， 读 者 将 会 看 到 一 个 全 新 并 且 会 改变 游戏 规则 的 
Spring 使 用 方式 ， 名 为 Spring Boot。 我 们 将 会 看 到 Spring Boot 如 何 
| 中 样板 式 的 配置 移 除 掉 ， 这 样 就 能 让 读者 更 加 专注 于 
业务 功能 。 


代码 规范 与 下 载 
本 书 中 有 大 量 的 示例 代码 。 这 些 代码 将 会 使 用 固定 宽度 的 代码 字体 。 本 
书 正文 中 的 类 名 、 方 法 名 或 XML 片段 也 都 使 用 代码 字体 。 


很 多 Spring 类 和 包 的 名 字 很 长 “不 过 会 有 较 强 的 表达 性 ) 。 鉴 于 此 ， 我 
们 有 时 候 会 用 到 换行 从 (ww)。 


本 书 中 的 示例 代码 并 不 都 是 完整 的 。 为 了 关注 某 个 主题 ， 我 有 时 候 只 会 
展示 类 的 一 个 或 两 个 方法 。 本 书 所 构建 的 应 用 程序 完整 代码 可 以 在 出 版 
社 站 点 上 下 载 ， 地 址 是 www.manning.com/SpringinActionFourthEdition。 

















作者 在 线 


购买 了 本 书 ， 读 者 束 可 以 免费 访问 Manning 出 版 社 提 供 的 在 线 论 坛 ， 在 
这 里 读者 可 以 给 本 书写 评论 ， 问 一 些 技术 问题 并 可 以 得 到 作者 和 其 他 用 
户 的 帮助 。 要 进入 这 个 论坛 或 订阅 它 ， 读 者 可 以 在 浏览 句 中 访问 
www.manning.com/SpringinActionFourthEdition。 这 个 页 面 会 告诉 读者 注 
册 后 怎样 进入 论坛 ， 能 够 得 到 什么 帮助 以 及 论坛 的 规则 。 

Manning 对 读者 的 许诺 是 为 读者 提供 一 个 交流 平台 ， 在 这 里 读者 之 间 以 
及 读者 和 作者 之 间 可 以 进行 有 意义 的 交流 。 对 于 作者 来 说 ， 对 论坛 进行 
多 少 次 的 访问 不 是 强制 的 ， 他 们 对 本 书 论坛 的 页 献 是 自愿 和 免费 的 。 我 
们 建议 读者 尽量 同 作者 问 一 些 有 挑战 性 的 问题 ， 以 保持 他 们 的 兴趣 ! 


只 要 本 书 还 在 发 售 ， 读 者 就 可 以 访问 作者 在 线 论 坛 以 及 以 前 讨论 的 归档 
信息 。 


封面 插图 简介 


《Spring 实战 》 第 4 版 的 封面 人 物 是 “Le Caraco”， 也 就 是 约旦 西南 部 卡拉 
克 《Karak) 省 的 居民 。 该 省 的 首府 是 Al-Karak， 那 里 的 山 项 有 座 古 城 
堡 ， 对 死海 和 周边 的 平原 有 着 极 佳 的 视野 。 这 幅 图 出 自 1796 年 出 版 的 法 
国旅 游 图 书 ，Encyclopédiedes Voyages， 该 书 由 J. G. St. Sauveur 编 
写 。 在 那 时 ， 为 了 娱乐 而 去 旅游 还 是 相对 新 鲜 的 做 法 ， 而 像 这 样 的 旅游 
指南 是 很 流行 的 ， 它 能 够 让 旅行 家 和 足 不 出 户 的 人 们 了 解法 国 其 他 地 区 
和 国外 的 居民 。 


Encyclopédiedes Voyages 中 多 种 多 样 的 图 画 生 动 描绘 了 200 年 前 世界 上 各 
个 城镇 和 地 区 的 独特 魅力 。 在 那 时 ， 相 隔 数 十 千 米 的 两 个 地 区 着 装 就 不 
相同 ， 可 以 通过 着 装 判 灯 人 们 究竟 属于 哪个 地 区 。 这 本 旅行 指南 展现 了 
那个 时 代 和 其 他 历史 时 代 的 隅 离 感 和 距离 感 ， 这 与 我 们 这 个 运动 过 度 的 
时 代 是 截然 不 同 的 。 


从 那 以 后 ， 服 装 风格 发 生 了 改变 ， 语 有 地 方 特色 的 多 样 性 开始 淡化 。 现 
在 ， 有 时 很 难说 一 个 洲 的 居民 和 其 他 洲 的 大 民有 什么 不 同 。 从 积极 的 方 
面 来 看 ， 我 们 或 许 是 用 原来 文化 和 视觉 上 的 多 样 性 换 来 了 个 人 风格 的 多 
变性 ， 或 者 可 以 说 是 更 为 多 样 化 和 有 趣 的 知识 科技 生活 。 


这 本 旅行 指南 中 的 图 片 反 映 了 两 个 世纪 前 各 个 地 区 生活 的 多 样 性 ， 我 们 
现在 用 图 书 封面 的 方式 对 其 进行 了 再 现 。Manning 出 版 社 的 员工 都 认为 
这 是 计算 机 行业 中 一 个 很 有 意思 的 创意 。 
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采 言 


百 尺 竿 头 更 进一步 。 十 几 年 前 ，Spring 刚 刚 进 入 Java 开 发 领域 ， 其 目标 
是 简化 企业 级 Java 开 发 。 它 使 用 更 为 简单 和 轻 量 级 的 模型 ， 该 模型 基于 
简单 老式 的 Java 对 象 ， 以 此 挑战 了 当时 重量 级 的 开发 模型 。 


现在 ， 已 经 过 去 了 很 多 年 ，Spring 也 发 布 了 众多 的 版 本 ， 我 们 可 以 看 到 
Spring 在 企业 级 应 用 开发 领域 书 丝 有 了 巨大 的 影响 力 。 对 于 无 数 的 Java 
项 目 来 说 ， 它 就 是 事实 上 的 标准 ， 并 且 对 于 一 些 规 范 和 和 它 本 来 想 取 代 的 
框架 ，Spring 也 对 其 演进 产生 了 影响 。 坚 无 疑问 ， 如 果 Spring 不 挑战 之 

前 版 本 的 企业 级 JavaBean 〈EJB) 规范 的 话 ， 现 在 的 EJB 规 范 肯定 是 完 

不 同 的 一 个 样子 。 


但 是 ，Spring 本 身 也 在 持续 地 演化 和 提升 ， 它 一 直 致 力 于 将 困难 的 开发 
任务 进行 简化 ， 不 断 地 为 Java 开 发 人 员 带 来 创新 性 的 特性 。 在 Spring 最 
初 所 挑战 的 领域 ，Spring 已 经 突 飞 独 进 ， 涉 及 的 范围 扩展 到 Java 心 用 开 
发 的 各 个 方面 。 


因此 ， 为 了 介绍 Spring 的 现状 ， 我 们 需要 对 这 本 书 升级 了 。 在 本 书 上 一 

版 出 版 到 现在 的 几 年 间 ， 发 生 了 太 多 的 事情 ， 想 在 这 一 版 中 将 所 有 的 变 

化 都 涵盖 进来 是 不 可 能 的 。 不 过 ， 在 第 4 版 的 《Spring 实 战 》 中 ， 我 依然 

> 内 容 。 下 面 列 出 了 在 这 一 版 中 新 增 的 一 些 令 人 兴 
J 新 内 容 : 


强调 基于 Java 的 Spring 配置 ， 基 于 Java 的 配置 方案 几乎 可 以 用 在 所 
有 Spring 开发 领域 之 中 ; 

条 件 化 的 配置 以 及 profile 特 性 能 够 让 Spring 在 运行 时 确定 该 使 用 或 
忽略 哪些 Spring 配置 ; 

Spring MVC 的 多 项 增强 和 改善 ， 尤 其 是 与 创建 REST 服 务 相 关 的 ; 
在 Spring 应 用 中 使 用 Thymeleaf 替 代 JSP; 

使 用 基于 Java 的 配置 启用 Spring Security; 

使 用 Spring Data， 在 运行 时 自动 为 JPA、MongoDB 和 Neo4j 生 成 
Repository 实 现 ; 

Spring 新 提供 的 声明 式 绥 存 文 持 ; 

。 借助 WebSocket 和 STOMP， 实 现 异 步 的 Web 消 息 ; 





。 Spring Boot， 改 变 使 用 Spring 游戏 规则 的 新 方法 。 


如 果 在 Spring 方面 读者 已 经 有 相当 多 经 验 的 话 ， 那 么 将 会 发 现 这 些 新 元 
素 对 于 自己 的 Spring 工具 箱 来 说 是 非常 有 价值 的 补充 。 如 果 读 者 是 要 学 
习 Spring 的 新 手 ， 那 么 就 赶 上 了 学 习 Spring 的 一 个 好 时 代 ， 这 本 书 会 帮 
助 恋 者 起 步 。 


对 于 Spring 的 使 用 来 说 ， 这 的 确 是 一 个 令 人 兴奋 的 时 代 。 在 过 去 的 12 年 
里 ， 在 使 用 Spring 进 行 开发 以 及 编写 与 之 相关 的 文章 方面 形成 了 一 股 浪 
滑 。 我 迫不及待 地 想 看 到 Spring 接 下 来 会 做 些 什么 ! 














译 痢 序 


3 年 前 ， 有 羊 和 耿 渊 同学 合作 翻译 了 《Spring 实 成 〈 第 3 版 ) 》。3 年 的 时 
光 过 去 了 了， 技术 在 不 断 有 发展， 这 本 书 也 推出 了 最 新 的 第 4 版 ， 顺 利 将 这 

本 书 翻译 完成 后 ， 顿 时 感觉 轻松 了 许多 。 译 书 是 一 件 比 较 辛苦 的 工作 ， 

但 是 在 这 3 年 的 时 间 内 ， 每 当 看 到 有 朋友 选择 本 书 来 学 习 Spring， 目 己 和 党 
得 还 是 灾 有 成 就 感 的 。 所 以 ， 看 到 本 书 的 第 4 版 时 ， 我 迫不及待 地 联系 

编辑 约定 了 本 书 的 翻译 事宜 。 


本 书 的 作者 Craig Walls 先 生 ， 从 10 年 前 编写 本 书 的 第 1 版 开始 ， 持 续 把 
一 件 事 情 做 好 ， 紧 跟 技 术 的 有 发展， 不 断 地 升级 和 更 新 这 本 书 的 内 容 ， 世 
界 范 围 内 无 数 的 Java 开 发 者 通过 这 本 书 学 习 和 和 擎 握 了 Spring 技术 。 


本 书 的 主题 是 Spring 框架 ， 从 十 多 年 前 问世 以 来 ， 它 一 直 致 力 于 简化 
JEE 应 用 的 开发 。 从 最 初 的 挑战 者 ， 到 现在 诸多 标准 的 制定 者 ;从 传统 
的 JEE 应 用 ， 到 大 数据 、NoSQL、 企 业 应 用 集成 、 批 处 理 、 移 动 开 发 等 
领域 ，Spring 都 在 参与 和 发 挥 影响 力 。 新 版 本 的 Spring 提 供 了 更 加 丰富 
的 功能 ， 但 更 重要 的 是 Spring 在 想 尽 办 法 简化 开发 人 员 的 使 用 ， 包 括 自 
动 配置 、 基 于 Java 的 配置 ， 还 有 现在 越 来 越 受到 欢迎 的 Spring Boot。 
Spring Boot 是 对 Spring 本 刁 的 一 种 其 约 和 间 命 ， 但 是 唯 有 这 种 是 获 ， 才 
会 换 来 开发 人 员 更 多 的 喜爱 和 框架 本 号 的 发 展 。 


这 本 书 从 第 1 版 到 第 4 版 之 所 以 长 盛 不 衰 ， 是 因为 它 紧 跟 了 技术 的 发 展 ; 
Spring 十 多 年 来 一 直 受 到 Java 开 发 者 的 青睐 ， 是 因为 它 不 断 地 进步 和 改 
善 ， 并 且 坚 持 最 初 的 目标 : 简化 企业 级 Java 的 开发 。 处 于 一 个 不 断 革 新 
的 领域 ， 我 们 搁 术 人 员 何 尝 不 需要 如 此 呢 ， 只 有 不 断 地 汲取 新 的 知识 ， 
学 习 新 的 技术 ， 才 能 保证 不 被 时 代 所 淘汰 。 


本 书 涵盖 了 Spring 框 染 的 许多 领域 ， 既 有 核心 框架 ， 也 有 各 种 功能 扩 
展 ， 不 少 的 同学 曾经 对 我 言及 ， 感 觉 书 中 所 讲述 的 内 容 深度 不 够 ,但 是 
我 个 人 认为 ， 对 于 开源 框架 的 学 习 ， 我 们 会 有 不 同 的 掌握 深度 ， 从 了 最 初 
始 的 使 用 、 配 置 ， 到 设计 原理 ， 再 到 源码 分 析 ， 一 本 书 很 难 面面俱到 深 
入 介绍 所 有 的 内 容 ， 但 是 它 却 能 够 提供 一 个 方向 ， 让 我 们 按 图 索 玩 深入 
学 习 更 多 的 知识 。 


























译 书 占用 了 大 量 的 业余 时 间 ， 因 此 感谢 我 的 爱人 ， 帮 我 承担 了 许多 家 务 
和 带 孩 子 的 工作 ， 还 要 感谢 我 的 儿子 ， 每 天 看 到 他 的 成 长 和 进步 ， 都 让 
我 感觉 如 果 懈 全 的 话 ， 该 被 小 朋友 嘲笑 了 。 


尽管 在 翻译 的 过 程 中 ， 我 力争 达到 准确 和 通畅 ， 并 与 作者 进行 了 很 多 的 
沟通 和 交流 ， 但 限于 水 平和 时 间 ， 肯 定 还 有 许多 的 不 足 或 纶 漏 之 处 ， 热 
忱 期 等 您 提出 意见 ， 希 望 本 书 能 够 对 您 有 用 ! 您 可 以 通过 
levinzhang1981@126.com 联 系 到 我 。 





张 卫 滨 
2015 年 11 月 于 大 连 


致谢 


在 本 书 付 印 之 前 ， 在 本 书 捆扎 之 前 ， 在 本 书 装 箱 之 前 ， 在 本 书 交付 运输 
之 前 ， 在 本 书 到 达 你 手 里 之 前 ， 在 整个 过 程 中 ， 有 很 多 双手 都 曾经 接触 
过 它 。 即 便 你 阅读 电子 版 ， 省 去 了 上 面 所 述 的 流程 ， 在 你 所 下 载 的 位 和 
字 节 上 依然 凝结 着 很 多 双手 的 辛勤 劳动 一 编辑 、 审 阅 、 录 入 以 及 校 

对 。 如 果 没 有 这 么 多 人 的 付出 ， 这 本 书 也 就 不 会 存在 了 。 


首先 ， 我 要 感谢 Manning 辛 苗 工作 的 每 个 人 ， 当 这 本 书 的 进展 速度 没有 
达到 预期 时 ， 他 们 给 予 了 足够 的 耐心 ， 并 促使 我 完成 这 本 书 : Marjan 
Bace、 Michael Stephens、Cynthia Kane、Andy Carroll、Benjamin Berg、 
Alyson Brener、Dottie Marisco、Mary Piergies、Janet Vail 以 及 幕后 的 其 
他 很 多 人 。 


写 书 的 时 候 ， 尺 早 和 频繁 的 反馈 是 相当 重要 的 ， 这 一 点 与 开发 软件 是 一 
样 的 。 当 这 本 书 还 非常 粗糙 的 时 候 ， 有 些 人 审阅 了 初稿 并 提供 反馈 ， 帮 
助 本 书 最 终 成 型 。 要 感谢 下 面 的 人 : Bob Casazza、Chaoho Hsieh、 
Christophe Martini、 Gregor Zurowski、James Wright、Jeelani Basha、 

Jens Richter、Jonathan Thoms、Josh Hart、Karen Christenson、Mario 
Arias、Michael Roberts、Paul Balogh、Ricardo da Silva Lima。 尤 其 要 感 
谢 John Ryan， 在 本 书 交 付 前 ， 他 对 书稿 进行 了 全 面 的 技术 审 校 。 


当然 ， 我 要 感谢 美丽 的 妻子 ， 感 谢 她 容忍 我 开始 了 这 个 新 的 写作 工程 ， 
感谢 她 整个 过 程 中 所 给 予 我 的 或 励 。 我 深 深 地 爱 痢 你 。 


Maisy 和 Madi， 世 界 上 最 可 爱 的 小 姑 女 ， 感 谢 你 们 的 拥抱 、 欢 关 以 及 对 
本 书 内 容 别 出 心 裁 的 见解 。 


对 于 Spring 团队 的 同事 ， 怎 么 说 呢 ? 你 们 太 酷 了 ! 能 够 作为 推动 Spring 
前 进 的 团队 中 的 一 员 ， 我 感到 非常 过 地 和 感激 。 你 们 层出不穷 的 新 创意 
总 是 让 我 感到 惊叹 。 

感谢 我 在 用 户 组 和 No Fluff/Just Stuff 会 议 上 演讲 时 所 遇 到 的 每 个 人 。 


最 后 ， 感 谢 Phoenicians， 你 们 (以 及 Epcot) 太 棒 了 ! 叫 























[1] “Phoenicians 指 的 是 远古 时 代 的 腓 尼 基 人 ， 他 们 被 认为 是 字母 系统 
的 创建 者 ， 基 于 字母 的 所 有 现代 语言 都 由 此 衍生 而 来 。 在 迪斯尼 世界 的 
Epcot， 有 名 为 Spaceship Earth 的 时 光 罕 梭 体 验 ， 我 们 可 以 了 解 到 人 类 区 
流 的 历史 ， 甚 至 能 够 回 到 腓 尼 基 人 的 时 代 ， 在 这 段 旅 程 的 旁白 中 这 样 说 
道 : 如 果 你 觉得 学 习 字 母语 言 很 容易 的 话 ， 那 感谢 腓 尼 基 人 吧 ， 是 他 们 
发 明了 它 。 这 是 作者 的 一 种 幽默 说 法 。 一 一 译 者 注 

















第 1 部 分 “Spring 的 核心 


Spring 可 以 做 很 多 事情 ， 它 为 企业 级 开发 提供 给 了 丰富 的 功能 ， 但 是 这 
些 功 能 的 底层 都 依赖 于 它 的 两 个 核心 特性 ， 也 就 是 依赖 注入 

(dependency injection，DI) 和 面 癌 切面 编程 〈aspect-oriented 
programming, AOP) 。 


作为 本 书 的 开始 ， 在 第 1 章 “Spring 之 旅 * 中 ， 我 将 快速 介绍 一 下 Spring 框 
ee DI 和 AOP 的 概况 ， 以 及 它们 是 如 何 帮 助 读 者 解 耘 应 用 组 





在 第 2 章 “ 装 配 Bean" 中 ， 我 们 将 深入 探讨 如 何 将 应 用 中 的 各 个 组 件 拼装 
ee Spring 所 提供 的 上 自动 配置 、 基 于 Java 的 配置 以 及 
XML 配置 。 


在 第 3 草 “ 岂 级 装配 ”中 ， 将 会 告别 基础 的 和 内容， 为 读者 展现 一 些 最 大 化 
Spring 威力 的 技巧 和 技术 ， 包 括 条 件 化 装配 、 处 理 目 动 装配 时 的 牙 义 
性 、 作 用 域 以 及 Spring 表达 式 语 言 。 


在 第 4 章 * 面 向 切面 的 Spring” 中 ， 展 示 如 何 使 用 Spring 的 AOP 特 性 把 系统 
级 的 服务 “例如 安全 和 审计 ) 从 它们 所 服务 的 对 象 中 解 耦 出 来 。 本 章 也 
为 后 面 的 第 9 章 、 第 13 章 和 第 14 章 做 了 铺垫 ， 这 几 章 将 会 分 别 介绍 如 何 

将 Spring AOP 用 于 声明 式 安 全 以 及 绥 存 。 











第 1 章 ”Spring 之 旅 


本 章 内 容 : 
Spring 的 bean 容 堪 


。 介绍 Spring 的 核心 模块 
。 更 为 强大 的 Spring 生态 系统 
e Spring 的 新 功能 


对 于 Java 程 序 员 来 说 ， 这 是 一 个 很 好 的 时 代 。 


在 Java 近 20 年 的 历史 中 ， 它 经 历 过 很 好 的 时 代 ， 也 经 历 过 饱 受 诉 病 的 时 
代 。 尽 管 有 很 多 粗糙 的 地 方 ， 如 applet、 企 业 级 JavaBean (Enterprise 

JavaBean，EJB) 、Java 数 据 对 象 〈Java Data Object，JDO) 以 及 无 数 的 
日 志 框 架 ， 但 是 作为 一 个 平台 ，Java 的 历史 是 丰富 多 彩 的 ， 有 很 多 的 企 
业 级 软件 都 是 基于 这 个 平台 构建 的 。Spring 是 Java 历 史 中 很 重要 的 组 成 


部 分 。 


在 诞生 之 初 ， 创 建 Spring 的 主要 目的 是 用 来 奉 代 更 加 重量 级 的 企业 级 
Java 技 术 ， 尤 其 是 EJB。 相 对 于 EJB 来 说 ，Spring 提 供 了 更 加 轻 量 级 和 简 
单 的 编程 模型 。 它 增强 了 简单 老式 Java 对 象 〈Plain Old Java object， 
POJO) 的 功能 ， 使 其 具备 了 之 前 只 有 EJB 和 其 他 企业 级 Java 规 范 才 具 有 
的 功能 。 


随 着 时 间 的 推移 ，EJB 以 及 Java 2 企业 版 〈Java 2 Enterprise Edition， 
J2EE) 在 不 靳 演化 。EJB 上 自身 也 提供 了 面向 简单 POJO 的 编程 模型 。 现 
在 ，EJB 也 采用 了 依赖 注入 ‘(Dependency Imjection，DI) 和 面向 切面 编 
程 (Aspect-Oriented Programming，AOP) 的 理念 ， 这 点 无 疑问 是 受到 
Spring 成 功 的 启发 。 


尽管 J2EE 〈 现 在 称 之 为 JEE) 能 够 赶 上 Spring 的 步伐 ， 但 Spring 也 没有 停 
目前 进 。Spring 继 续 在 其 他 领域 发 展 ， 而 JEE 则 刚刚 开始 涉及 这 些 领 
域 ， 或 者 还 完全 没有 开始 在 这 些 领域 的 创新 。 移 动 开 发 、 社 交 API 集 
成 、NoSQL 数 据 库 、 云 计算 以 及 大 数据 都 是 Spring 正在 涉足 和 创新 的 领 
域 。Spring 的 前 景 依然 会 很 美好 。 

















正如 我 之 前 所 言 ， 对 于 Java 开 发 者 来 说 ， 这 是 一 个 很 好 的 时 代 。 


本 书 会 对 Spring 进 行 研究 ， 在 这 一 章 中 ， 我 们 将 会 在 较为 宏观 的 层面 上 
介绍 Spring， 让 你 对 Spring 是 什么 有 直观 的 体验 。 本 章 将 让 读者 对 Spring 
所 解决 的 各 类 问题 有 一 个 清晰 的 认识 ， 同 时 为 其 他 章 葛 定 基 础 。 





1.1 简化 Java 开 发 


Spring 是 一 个 开源 框架 ， 最 早 由 Rod Johnson 创 建 ， 并 在 《Expert One-on- 
One: J2EE Design and Development》 (http://amzn.com/076454385) 这 
本 车 作 中 进行 了 介绍 。Spring 是 为 了 解决 企业 级 应 用 开发 的 复杂 性 而 创 
建 的 ， 使 用 Spring 可 以 让 简单 的 JavaBean 实 现 之 前 只 有 EJB 才 能 完成 的 事 
情 。 但 Spring 不 仅仅 局 限于 服务 喜 端 开发 ， 任 何 Java 应 用 都 能 在 简单 
性 、 可 测试 性 和 松 耘 合 等 方面 从 Spring 中 获 益 。 


bean 的 各 种 名 称 .……. 虽然 Spring 用 bean 或 者 JavaBean 来 表示 应 用 组 件 ， 
但 并 不 意味 着 Spring 组 件 必 须要 遵循 JavaBean 规 范 。 一 个 Spring 组 件 可 以 
是 任何 形式 的 POJO。 在 本 书 中 ， 我 采用 JavaBean 的 广泛 定义 ， 即 POJO 
的 同义词 。 


纵览 全 书 ， 读 者 会 发 现 Spring 可 以 做 非常 多 的 事情 。 但 归根 结 底 ， 文 撑 
Spring 的 仅仅 是 少许 的 基本 理念 ， 所 有 的 理念 都 可 以 妃 调 到 Spring 最 根 
本 的 使 命 上 : 简化 Java 开 发 。 


这 是 一 个 郑重 的 承诺 。 许 多 框架 都 声称 在 某 些 方面 做 了 简化 ， 但 Spring 
的 目标 是 致力 于 全 方位 的 简化 Java 开 发 。 这 势必 引出 更 多 的 解释 ， 
Spring 是 如 何 简化 Java 开 发 的 ? 


为 了 降低 Java 开 发 的 复杂 性 ，Spring 采 取 了 以 下 4 种 关键 策略 : 


基于 POJO 的 轻 量 级 和 最 小 侵入 性 编程 ; 
通过 依赖 注入 和 面向 接口 实现 松 耦 合 ; 
基于 切面 和 惯例 进行 声明 式 编程 ; 
通过 切面 和 模板 减少 样板 式 代码 。 


几乎 Spring 所 做 的 任何 事情 都 可 以 追溯 到 上 述 的 一 条 或 多 条 策略 。 在 本 
章 的 其 他 部 分 ， 我 将 通过 具体 的 案例 进一步 前 述 这 些 理念 ， 以 此 来 证 明 
Spring 是 如 何 完 美 芜 现 它 的 承 诡 的 ， 也 就 是 简化 Java 开 发 。 让 我 们 先 从 
基于 POJO 的 最 小 侵入 性 编程 开始 。 




















1.1.1 激发 POJO 的 潜能 


如 有 果 你 从 事 Java 编 程 有 一 段 时 间 了， 那么 你 或 许 会 发 现 〈( 可 能 你 也 实际 
使 用 过 ) 很 多 框架 通过 强迫 应 用 继承 它们 的 类 或 实现 它们 的 接口 从 而 导 
致 应 用 与 框架 绑 死 。 一 个 典型 的 例子 是 EJB 2 时 代 的 无 状态 会 话 bean。 
早期 的 EJB 是 一 个 很 容易 想到 的 例子 ， 不 过 这 种 侵入 式 的 编程 方式 在 早 
期 版 本 的 Struts、WebWork、Tapestry 以 及 无 数 其 他 的 Java 规 范 和 框架 中 
都 能 看 到 。 


Spring 总 力 避 免 因 自 喘 的 API 而 弄 乱 你 的 应 用 代码 。Spring 不 会 强迫 你 实 
现 Spring 规 范 的 接口 或 继承 Spring 规范 的 类 ， 相 反 ， 在 基于 Spring 构建 的 
应 用 中 ， 它 的 类 通常 没有 任何 痕迹 表明 你 使 用 了 Spring。 最 坏 的 场景 
是 ， 一 个 类 或 许 会 使 用 Spring 注解 ， 但 它 依旧 是 POJO。 

不 妨 举 个 例子 ， 请 参考 下 面 的 HelloWorldBean 类 : 


程序 清单 1.1 Spring 不 会 在 HelloWorldBean 上 有 任何 不 合理 的 要 求 











public class loWorldBean { 
public String sayHello() i 这 就 是 你 所 需要 做 的 


可 以 看 到 ， 这 是 一 个 简单 普通 的 Java 类 一 一 POJO。 没 有 任何 地 方 表明 它 
是 一 个 Spring 组 件 。Spring 的 非 侵 入 编程 模型 意味 着 这 个 类 在 Spring 应 用 
和 非 Spring 应 用 中 都 可 以 发 挥 同 样 的 作用 。 


尽管 形式 看 起 来 很 简单 ， 但 POJO 一 样 可 以 具有 魔力 。Spring 赋 子 POJO 


魔力 的 方式 之 一 就 是 通过 DI 来 装配 它们 。 让 我 们 看 看 DI 是 如 何 帮 助 应 用 
对 象 彼此 之 间 保 持 松散 耦合 的 。 

1.1.2 ”依赖 注入 

依赖 注入 这 个 词 让 人 望 而 生 有 ， 现 在 已 经 演变 成 一 项 复杂 的 编程 技巧 或 
设计 模式 理念 。 但 事实 证 明 ， 依 赖 注 入 并 不 像 它 听 上 去 那么 复杂 。 在 项 
es 你 会 发 现 你 的 代码 会 变 得 异 和 党 简单 并 且 更 容易 理解 和 测 
TENo 


DI 功 能 是 如 何 实现 的 











任何 一 个 有 实际 意义 的 应 用 (肯定 比 Hello World 示 例 更 复杂 ) 都 会 由 两 
个 或 者 更 多 的 类 组 成 ， 这 些 类 相互 之 间 进 行 协作 来 完成 特定 的 业务 思 
辑 。 按 照 传 统 的 做 法 ， 每 个 对 象 负 责 管 理 与 自己 相互 协作 的 对 象 〈“ 即 它 
所 依赖 的 对 象 ) 的 引用 ， 这 将 会 导致 高 度 耘 合 和 难以 测试 的 代码 。 


举 个 例子 ， 考 虑 下 程序 清单 1.2 所 展现 的 Knight 类 。 


程序 清单 1.2 DamselRescuingKnight 只 能 执行 RescueDamselQuest 探 险 
任务 











E kage com.springinar knig 
public cl i J impl emer Knight 
private RescueDamselNuest guest; 
public DamselRescuyuingKnight{() { 与 RescueDamselOuest 紧 下 合 
this.quest = new RescueDamselQuest {); 
publi oid embarkonouest 
due .Embark! 


可 以 看 到 ，DamselRescuingKnight 在 它 的 构造 函数 中 自行 创建 了 
Rescue DamselQuest。 这 使 得 DamselRescuingKnight 紧 密 地 和 
RescueDamselQuest 耘 合 到 了 一 起 ， 因 此 极 大 地 限制 了 这 个 骑士 执行 
探险 的 能 力 。 如 果 一 个 少女 需要 救援 ， 这 个 骑士 能 够 召 之 即 来 。 但 是 如 
果 一 条 和 恶 龙 需要 杀 掉 ， 或 者 一 个 圆 昌 .……. 额 .…… 需 要 滚 起 来 ， 那 么 这 个 
骑士 就 爱 英 能 助 了 。 


更 糟糕 的 是 ， 为 这 个 DamselRescuingKnight 编 写 单元 测试 将 出 奇 地 困 
难 。 在 这 样 的 一 个 测试 中 ， 你 必须 保证 当 骑 士 的 embarkonQuest() 方 
法 被 调用 的 时 候 ， 探 险 的 embark() 方 法 也 要 被 调用 。 但 是 没有 一 个 简 
单 明 了 的 方式 能 够 实现 这 一 点 。 很 遗憾 ，DamselRescuingkKnight 将 无 
法 进行 测试 。 


耦合 具有 两 面 性 〈two-headed beast) 。 一 方面 ， 紧 密 耦 合 的 代码 难以 测 
试 、 难 以 复 用 、 难 以 理解 ， 并 且 典 型 地 表现 出 “ 打 地 鼠 ” 式 的 bug 特 性 

(修复 一 个 bug， 将 会 出 现 一 个 或 者 更 多 新 的 bug) 。 男 一 方面 ， 一 定 程 
度 的 耦合 又 是 必须 的 一 一 完全 没有 耦合 的 代码 什么 也 做 不 了 。 为 了 完成 











有 实际 意义 的 功能 ， 不 同 的 类 必须 以 适当 的 方式 进行 区 互 。 总 而 言 之 ， 
耦合 是 必须 的 ， 但 应 当 被 小 心 齐 慎 地 管理 。 


通过 DI， 对 象 的 依赖 天 系 将 由 系统 中 负责 协调 各 对 象 的 第 三 方 组 件 在 创 
建 对 象 的 时 候 进 行 设 定 。 对 象 无 需 目 行 创建 或 管理 它们 的 依赖 关系 ， 如 
图 1.1 所 示 ， 依 赖 关 系 将 极目 动 注入 到 需要 它们 的 对 象 当中 去 。 








图 1.1 依赖 注入 会 将 所 依赖 的 关系 自动 交 给 目标 对 象 ， 而 不 是 让 对 象 自己 去 获取 依赖 


为 了 展示 这 一 点 ， 让 我 们 看 一 看 程序 清单 1.3 中 的 BraveKnight， 这 个 
骑士 不 仅 勇 敢 ， 而 且 能 挑战 任何 形式 的 探险 。 











程序 清单 1.3 ”BraveKnight 足 够 灵活 可 以 接受 任何 赋予 他 的 探险 任务 


package com.springinaction.knights; 


Ptiblic class BraveKnight implements Knight 1 
private Quest quest; 
public BraveKknight (Quest quest)} Quest 被 注 人 进 来 
this.quest = quest; 
} 
1 1 1 embarkOnNuest 
mbark(}; 


我 们 可 以 看 到 ， 不 同 于 之 前 的 DamselRescuingKnight, BraveKnight 
没有 自行 创建 探险 任务 ， 而 是 在 构造 的 时 候 把 探险 任务 作为 构造 器 参数 
传 入 。 这 是 依赖 注入 的 方式 之 一 ， 即 构造 器 注入 (constructor 


injection) 。 


更 重要 的 是 ， 传 入 的 探险 类 型 是 Quest， 也 就 是 所 有 探险 任务 都 必须 实 
现 的 一 个 接口 。 所 以 ，BraveKnight 能 够 响应 RescueDamselQuest、 
SlayDragonQuest、MakeRoundTableRounderQuest 等 任意 的 Quest 
实现 。 


这 里 的 要 点 是 BraveKknight 没 有 与 任何 特定 的 Quest 实 现 发 生 耦 合 。 对 
它 来 说 ， 被 要 求 挑战 的 探险 任务 只 要 实现 了 Quest 接 口 ， 那 么 具体 是 哪 
种 类 型 的 探险 承 无 关 紧 要 了 。 这 就 是 DI 所 带 来 的 最 大 收益 一 一 松 耘 合 。 
如 果 一 个 对 象 只 通过 接口 (而 不 是 具体 实现 或 初始 化 过 程 ) 来 表明 依赖 
关系 ， 那 么 这 种 依赖 就 能 够 在 对 象 本 身 训 不 知情 的 情况 下 ， 用 不 同 的 具 
体 实现 进行 蔡 换 。 


对 依赖 进行 蔡 换 的 一 个 最 常用 方法 就 是 在 测试 的 时 候 使 用 mock 实 现 。 
我 们 无 法 充分 地 测试 DamselRescuingKknight， 因 为 它 是 紧 耦 合 的 ; 但 
是 可 以 轻松 地 测试 BraveKnight， 只 需 给 它 一 个 Quest 的 mock 实 现 即 
可 ， 如 程序 清单 1.4 所 示 。 


程序 清单 1.4 为 了 测试 BraveKnight， 需 要 注入 一 个 mock Quest 














package com.springinaction.knights; 
import static org.mockito.Mockito.*; 
import org.junit.Test; 
public class BraveKknightTest { 
@Test 
public void knightShouldEmbarkOnQuest() { 
Quest mockQuest = mock{(Quest.class); 4 创建 mock Quest 
BraveKnight knight = new BraveKnight (mockQuest); < 注 人 mock Quest 


knight .embarkonouest () ; 


7 4 


Verify ImockQuest，times(1L)) .embark!(); 
} 


你 可 以 使 用 mock 框 架 Mockito 去 创建 一 个 Quest 接 口 的 mock 实 现 。 通 过 
这 个 mock 对 象 ， 就 可 以 创建 一 个 新 的 BraveKnight 实 例 ， 并 通过 构造 
器 注入 这 个 mock Quest。 当 调用 embarkOnQuest() 方 法 时 ， 你 可 以 要 
求 Mockito 框 架 验 证 Quest 的 mock 实 现 的 embark() 方 法 仅仅 被 调用 了 一 
次 。 


将 Quest 注 入 到 Knight 中 


现在 BraveKnight 类 可 以 接受 你 传递 给 它 的 任意 一 种 Quest 的 实现 ， 但 
该 怎样 把 特定 的 Quest 实 现 传 给 它 呢 ? 假设 ， 和 希望 BraveKnight 所 要 进 
行 探险 任务 是 杀 死 一 只 怪 龙 ， 那 么 程序 清单 1.5 中 的 SlayDragonQuest 
也 许 是 挺 合 适 的 。 


程序 清单 1.5 SlayDragonQuest 是 要 注入 到 BraveKnight 中 的 Quest 实 现 
package com.springinaction.knights; 
import java.io.PrintStream; 


public class SlayDragonQuest implements Quest { 


private PrintStream stream; 


public SlayDragonQuest(PrintStream stream) { 
this.stream = stream; 


} 


public void embark() { 
stream.println("Embarking on quest to slay the dragon!"); 


} 





我 们 可 以 看 到 ，SlayDragonQuest 实 现 了 Quest 接 口 ， 这 样 它 就 适合 注 
入 到 BraveKnight 中 去 了 。 与 其 他 的 Java 入 门 样 例 有 所 不 

同 ，SlayDragonQuest 没 有 使 用 System.out.println()， 而 是 在 构 
造 方 法 中 请 求 一 个 更 为 通用 的 Printstream。 这 里 最 大 的 问题 在 于 ， 我 
们 该 如 何 将 SlayDragonQuest 交 给 BraveKnight 呢 ?又 如 何 

将 Printstream 交 给 SlayDragonQuest 呢 ? 


创建 应 用 组 件 之 间 协 作 的 行为 通常 称 为 装配 (wiring) 。Spring 有 多 种 
装配 bean 的 方式 ， 采 用 XML 是 很 常见 的 一 种 装配 方式 。 程 序 清单 1.6 展 
现 了 一 个 简单 的 Spring 配置 文件 : knights.xzml， 该 配置 文件 

将 BraveKnight、SlayDragonQuest 和 Printstream 装 配 到 了 一 起 。 


程序 清单 1.6 ”使 用 Spring 将 SlayDragonQuest 注 入 到 BraveKnight 中 


"TEFSBn2> 


< 了 ?了 Xml version="1.0" encoding 


<beans xmlns="http:/ www.SDPringtramewoIrx ,org/schema/beans" 


xmlns:;xsi="http;/ /ww ,wi3,.org/2001/XMDLSchema-instance' 
xsi:'schemaLocation="http:/ /www. springframework.org/schema,/beans 
http:/ /www. springftramework.org/schema/beans/spring-beans.xsd"> 


<bean id="knight" class="com.springinaction.knights.BraveKnight"> 
“Constructor-arg ref="guest" /> 
ES 和 让 人 Quest bean 


<bean id="quest” class="com.SsDringinaccilon.knichts.SlIayDragonQuest "> 
“Constructor-arg value="#{TISystem) .out}" / 


Ey 创建 SlayDragonQuest 


</beans> 


在 这 里 ，BraveKnight 和 SlayDragonQuest 被 声明 为 Spring 中 的 bean。 
就 BraveKnight bean 来 讲 ， 它 在 构造 时 传 入 了 对 SlayDragonQuest 
bean 的 引用 ， 将 其 作为 构造 器 参数 。 同 时 ，SlayDragonQuest bean 的 
声明 使 用 了 Spring 表 达 式 语言 (Spring Expression Language) ， 

将 System.out (这 是 一 个 Printstream) 传 入 到 了 SlayDragonQuest 
的 构造 器 中 。 

如 果 XML 配 置 不 符合 你 的 喜好 的 话 ，Spring 还 支持 使 用 Java 来 描述 配 
比如 ， 程 序 清 单 1.7 展 现 了 基于 Java 的 配置 ， 它 的 功能 与 程序 清单 
1.6 相 同 。 


程序 清单 1.7 “Spring 提供 了 基于 Java 的 配置 ， 可 作为 XML 的 替代 方案 





package com.springinaction.knights.config; 


import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


import com.springinaction.knights.BraveKnight; 
import com.springinaction.knights.Knight; 

import com.springinaction.knights.Quest; 

import com.springinaction.knights.SlayDragonQuest; 


@Configuration 
public class KnightConfig { 


@Bean 
public Knight knight() { 
return new BraveKnight(quest()); 


} 


@Bean 
public Quest quest() { 
return new SlayDragonQuest(System.out); 


} 





不 管 你 使 用 的 是 基于 XML 的 配置 还 是 基于 Java 的 配置 ，DI 所 带 来 的 收益 
都 是 相同 的 。 尽 管 BraveKknight 依 赖 于 Quest， 但 是 它 并 不 知道 传递 给 
它 的 是 什么 类 型 的 Quest， 也 不 知道 这 个 Quest 来 自 哪里 。 与 之 类 








似 ，SlayDragonQuest 依 赖 于 Printstream， 但 是 在 编码 时 它 并 不 需 
要 知道 这 个 PrintStream 是 什么 样子 的 。 只 有 Spring 通过 它 的 配置 ， 能 
够 了 解 这 些 组 成 部 分 是 如 何 装 配 起 来 的 。 这 样 的 话 ， 就 可 以 在 不 改变 所 
依赖 的 类 的 情况 下 ， 修 改 依赖 关系 。 


这 个 样 例 展现 了 在 Spring 中 装配 bean 的 一 种 简单 方法 。 谨 记 现 在 不 要 过 
多 关注 细节 。 第 2 章 我 们 会 深入 讲解 Spring 的 配置 文件 ， 同 时 还 会 了 解 
Spring 装配 bean 的 其 他 方式 ， 甚 至 包括 一 种 让 Spring 目 动 发 现 bean 并 在 这 
些 bean 之 间 建 立 关联 关系 的 方式 。 


现在 已 经 声明 了 BraveKnight 和 Quest 的 关系 ， 接 下 来 我 们 只 需要 装载 
XML 配置 文件 ， 并 把 应 用 局 动 起 来 。 


观察 它 如 何 工 作 


Spring 通过 应 用 上 下 文 (Application Context) 装载 bean 的 定义 并 把 它们 
组 装 起 来 。Spring 应 用 上 下 文 全 权 负 责 对 象 的 创建 和 组 装 。Spring 自 佛 
了 多 种 应 用 上 下 文 的 实现 ， 它 们 之 间 主 要 的 区 别 仅仅 在 于 如 何 加 载 配 
置 。 


为 knights.xml 中 的 bean 是 使 用 XML 文 件 进行 配置 的 ， 所 以 选择 
ClassPathXmlApplicationContext[l1 作 为 应 用 上 下 文 相 对 是 比较 合 
适 的 。 访 类 加 载 位 于 应 用 程序 类 路 径 下 的 一 个 或 多 个 XML 配置 文件 。 
程序 清单 1.8 中 的 main() 方 法 调用 ClassPathXmlApplicationContext 
加 载 knights.xml， 并 获得 Knight 对 象 的 引用 。 




















程序 清单 1.8 KnightMain.java 加 载 包 合 Knight 的 Spring 上下文 


package com.springinaction.knights; 


import org.springframework.context.support. 
ClassPathxXmlApplicationContext; 


public class KnightMain { 
public static void main(String[] args) throws Exception { 加 载 Spring 
ClassPathXmlApplicationContext context = < -下 文 
new ClassPathxmlApplicationContext( 
"META-INF/spring/knights.xml"); | 获取 knight 
Knight knight = context .getBeanlKnight .class); 1 bean 
knight .embarkOonQuest (); + 使 用 knight 


Context .closel():; 


} 


} 


这 里 的 main() 方 法 基于 knights.xml 文 件 创 建 了 Spring 应 用 上 下 文 。 随 后 
它 调 用 该 应 用 上 下 文 获 取 一 个 ID 为 knight 的 bean。 得 到 Knight 对 象 的 引 
用 后 ， 只 需 简 简单 调用 embarkOnQuest( ) 方 法 就 可 以 执行 所 赋予 的 探险 
任务 了 。 注 意 这 个 类 完全 不 知道 我 们 的 英雄 骑士 接受 哪 种 探险 任务 ， 而 
且 完 全 没有 意识 到 这 是 由 BraveKnight 来 执行 的 。 只 有 knights.xml 文 件 
知道 哪个 骑士 执行 哪 种 探险 任务 。 


通过 示例 我 们 对 依赖 注入 进行 了 一 个 快速 介绍 。 纵 哆 全 书 ， 你 将 对 依赖 
注入 有 更 多 的 认识 。 如 果 你 想 了 解 更 多 关于 依赖 注入 的 信息 晨 ， 我 推荐 阅 
读 Dhanji R. Prasanna 的 《Dependency Injection》， 该 著作 履 访 了 依赖 注 
入 的 所 有 内 容 。 


现在 让 我 们 再 关注 Spring 简 化 Java 开 发 的 下 一 个 理念 ， 基 于 切面 进行 声 
明 式 编程 。 


1.1.3 ”应 用 切面 


DI 能 够 让 相互 协作 的 软件 组 件 保持 松散 耦合 ， 而 面向 切面 编程 〈aspect- 
oriented programming，AOP) 人 允许 你 把 遍布 尺 人 用 各 处 的 功能 分 离 出 来 形 
成 可 重用 的 组 件 。 


面 癌 切面 编程 往往 被 定义 为 促使 软件 系统 实现 关注 点 的 分 离 一 项 技术 
系统 由 许多 不 同 的 组 件 组 成 ， 每 一 个 组 件 各 负责 一 块 特定 功能 除了 实 
现 自身 核心 的 功能 之 外 ， 这 些 组 件 还 经 常 承担 着 额外 的 职责 。 诸 如 日 
志 、 事 务 管理 和 安全 这 样 的 系统 服务 经 常 融入 到 自身 具有 核心 业务 逻辑 
的 组 件 中 去 ， 这 些 系统 服务 通常 被 称 为 模 切 关注 点 ， 因 为 它们 会 跨越 系 











统 的 多 个 组 件 。 


0 0. 0 
性。 


。 实现 系统 关注 点 功能 的 代码 将 会 重复 出 现在 多 个 组 件 中 。 这 意味 着 
如 末 你 要 改变 这 些 关 注 点 的 逻辑 ， 必 须 修改 备 个 模块 中 的 相关 实 
现 。 即 使 你 把 这 些 关 注 点 抽象 为 一 个 独立 的 模块 ， 其 他 模块 只 是 调 
用 它 的 方法 ， 但 方法 的 调用 还 是 会 重复 出 现在 各 个 模块 中 。 

。 组 件 会 因为 那些 与 自 喘 核心 业务 无 关 的 代码 而 变 得 混乱 。 一 个 辣 地 
址 禾 增 加 地 址 条 目的 方法 应 该 只 关注 如 何 添加 地 址 ， 而 不 应 该 关注 
它 是 不 是 安全 的 或 者 是 否 需 要 文 持 事 务 。 


图 1.2 展 示 了 这 种 复杂 性 。 左 边 的 业务 对 象 与 系统 级 服务 结合 得 过 于 紧 
密 。 每 个 对 象 不 但 要 知道 它 需要 记 日 志 、 进 行 安全 控制 和 参与 事务 ， 还 














ce 
要 杀 目 执行 这 些 服务 。 


课程 服务 





计 费 服务 


图 1.2 在 整个 系统 内 ， 关 注 点 (例如 日 志和 安全 ) 
的 调用 经 常 散布 到 各 个 模块 中 ， 而 这 些 关 注 点 并 不 是 模块 的 核心 业务 


AOP 能 够 使 这 些 服务 模块 化 ， 并 以 声明 的 方式 将 它们 应 用 到 它们 需要 影 
响 的 组 件 中 去 。 所 造成 的 结果 就 是 这 些 组 件 会 具有 更 高 的 内 聚 性 并 且 会 
更 加 关注 自身 的 业务 ， 完 全 不 需要 了 解 涉及 系统 服务 所 带 来 复杂 性 。 总 
之 ，AOP 能 够 确保 POJO 的 简单 性 。 


如 图 1.3 所 示 ， 我 们 可 以 把 切面 想象 为 履 盖 在 很 多 组 件 之 上 的 一 个 外 
壳 。 应 用 是 由 那些 实现 各 目 业 务 功能 的 模块 组 成 的 。 借 助 AOP， 可 以 使 
































用 各 种 功能 层 去 包 衷 核心 业务 层 。 这 些 层 以 声明 的 方式 灵活 地 应 用 到 系 
统 中 ， 你 的 核心 应 用 甚至 根本 不 知道 它们 的 存在 。 这 是 一 个 非常 强大 的 
理念 ， 可 以 将 安全 、 事 务 和 日 志 关 注 点 与 核心 业务 逻辑 相 分 离 。 


图 1.3 利 





课程 服务 





讲师 服务 


计 费 服务 内 容 服务 




















AOP， 系 统 范 














围 内 的 关注 点 覆盖 在 它们 所 影响 组 件 之 上 





为 了 示范 在 Spring 中 如 何 应 用 切面 ， 让 我 们 重新 回 到 骑士 的 例子 ， 并 为 


它 添加 一 个 切面 。 


AOP 应 用 





每 一 个 人 者 的 知 骑士 所 做 的 任何 事情 ， 这 是 因为 吟 游 许 人 用 诗歌 记载 了 
骑士 的 事迹 并 将 其 进行 传唱 。 
记载 骑士 的 所 有 事迹 。 程 序 清单 1.9 展 示 了 我 们 会 使 用 的 Minstrel 类 ，。 


程序 清单 1.9 ” 吟 游 诗人 是 中 世纪 的 首 乐 记录 器 











假设 我 们 需要 使 用 吟 游 诗 人 这 个 服务 类 来 


package com.springinaction.knights; 


import java.io,.Printstream; 


public Minstrel{Printstream stream) 1{ 


th 1 5S.5tream = stream; 
public void singBeforeQuest() 1 探险 之 前 调用 
stream.printint"Fa la la, the knight is so brave!"); 


5 2 3 
public void singAfterQuest!{) 1 氏 险 之 后 调用 


stream.printinl"Tee hee hee, the brave knight " 


"did embark on a gquest!"),; 


正如 你 所 看 到 的 那样 ，Minstre1 是 只 有 两 个 方法 的 简单 类 。 在 骑士 执 
行 每 一 个 探险 任务 之 前 ，singBeforeQuest(1) 方 法 会 被 调用 ; 在 骑士 
完成 探险 任务 之 后 ，singAfterQuest() 方 法 会 被 调用 。 在 这 两 种 情况 
下 ，Minstrel 都 会 通过 一 个 Printstream 类 来 歌颂 骑士 的 事迹 ， 这 个 
类 是 通过 构造 器 注入 进来 的 。 


把 Minstrel 加 入 你 的 代码 中 并 使 其 运行 起 来 ， 这 对 你 来 说 是 小 事 
桩 。 我 们 适当 做 一 下 调整 从 而 让 BraveKnight 可 以 使 用 Minstrel。 程 
序 清单 1.10 展 示 了 将 BraveKnight 和 Minstrel 组 合 起 来 的 第 一 次 尝试 。 














程序 清单 1.10 ”BraveKnight 必 须要 调用 Minstrel 的 方法 


package com.springinaction.knights; 


public class BraveKnight implements Knight 1{ 


private Quest quest; 

private Minstrel minstrel; 

public BraveKnight (Quest quest, Minstrel minstrel) { 
this.auest = quest; 


this.minstrel = minstrel; 


} 


public void embarkonQuest{) throws QuestException { 
minstrel.singBeforeQuest(); < er a ne 
Knight 应 该 管理 它 的 


quest .embark(); ‘ 
Minstrel (3? 


minstrel.singAfterQuest!{); 


} 


} 


这 应 该 可 以 达到 预期 效果 。 现 在 ， 你 所 需要 做 的 就 是 回 到 Spring 配 置 
中 ， 声 明 Minstrel bean 并 将 其 注入 到 BraveKnight 的 构造 器 之 中 。 但 
是 ， 请 稍 等 .….…. 


我 们 似乎 感觉 有 些 东 西 不 太 对 。 管 理 他 的 吟 游 诗人 真 的 是 骑士 职责 范围 
内 的 工作 吗 ? 在 我 看 来 ， 吟 游 诗 人 应 该 做 他 份 内 的 事 ， 根 本 不 需要 骑士 
命令 他 这 么 做 。 毕 竟 ， 用 诗歌 记载 骑士 的 探险 事迹 ， 这 是 吟 游 许 人 的 职 
责 。 为 什么 骑士 还 需要 提醒 吟 游 诗 人 去 做 他 份 内 的 事情 呢 ? 


此 外 ， 因 为 骑士 需要 知道 吟 游 诗人 ， 所 以 束 必 须 把 吟 游 诗 人 注入 

到 BarveKnight 类 中 。 这 不 仅 使 BraveKnight 的 代码 复杂 化 了 ， 而 且 还 
让 我 疑惑 是 否 还 需要 一 个 不 需要 吟 游 主人 的 骑士 呢 ? 如 果 Minstrel 
为 nul1 会 发 生 什么 呢 ? 我 是 否 应 该 引入 一 个 空 值 校 验 逻 辑 来 覆盖 该 场 


上 且 
厅 ? 


























简单 的 BraveKnight 类 开始 变 得 复杂 ， 如 果 你 还 需要 应 对 没有 吟 游 诗人 
时 的 场景 ， 那 代码 会 变 得 更 复杂 。 但 利用 AOP， 你 可 以 声明 吟 游 诗人 必 
须 歌颂 骑士 的 探险 事迹 ， 而 骑士 本 里 并 不 用 直接 访问 Minstrel 的 方 
A 


要 将 Minstre1 抽 象 为 一 个 切面 ， 你 所 需要 做 的 事情 就 是 在 一 个 Spring 配 
置 文件 中 声明 它 。 程 序 清单 1.11 是 更 新 后 的 knights.xml 文 件 ，Minstrel 
被 声明 为 一 个 切面 。 











程序 清单 1.11 将 Minstrel 声 明 为 一 个 切面 


<?xml version="1.0" encoding="UTF-8"?>> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop'" 
xsi:schemaLocation="http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop-3.2.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="knight" class="com.springinaction.knights.BraveKnight"> 
<constructor-arg ref="quest" /> 
</bean> 


<bean id="quest" class="com.springinaction.knights.SlayDragonQuest"> 
<constructor-arg value="#{T(System) .out}" /> 
</bean> 


<bean id="minstrel" class="com.springinaction.knights.Minstrel"> 
<constructor-arg value="#{T(System) .out}" /> Ea 
EE Vy ) 声明 Minstrel bean 
</bean> 


<aop:config> 
<aop:aspect ref="minstrel"> 


<aop:pointcut id="embark" 定义 切 点 
expression="execution{* *.embarkOnQuest(..})})"/> 4 | 
<aop:before pointcut-ref="embark" 4 声明 前 置 通知 


method="singBeforeQuest"/> 


<aop:after pointcut-ref="embark" 4 声明 后 置 通 知 
method="singAfterQuest"/> 
</aop:aspect> 
</aop:config> 


</beans> 


这 里 使 用 了 Spring 的 aop 配 置 命 名 空间 把 Minstrel bean 声 明 为 一 个 切 
面 。 首 先 ， 需 要 把 Minstrel 声 明 为 一 个 bean， 然 后 在 <aop:aspect> 元 
素 中 引用 该 bean。 为 了 进一步 定义 切面 ， 声 明 (使 用 <aop:before>) 
在 embarkOnQuest() 方 法 执行 前 调用 Minstrel 的 singBeforeQuest() 
方法 。 这 种 方式 被 称 为 前 置 通知 (before advice) 。 同 时 声明 〈 使 

用 <aop:after>) 在 embarkOnQuest() 方 法 执行 后 调用 singAfter 
Quest() 方 法 。 这 种 方式 被 称 为 后 置 通知 (after advice) 。 


在 这 两 种 方式 中 ，pointcut-ref 属 性 都 引用 了 名 字 为 embark 的 切入 
点 。 该 切入 点 是 在 前 边 的 <pointcut> 元 素 中 定义 的 ， 并 配 
置 expression 属 性 来 选择 所 应 用 的 通知 。 表 达 式 的 语法 采用 的 是 


AspectJ 的 切 点 表达 式 语 言 。 


现在 ， 你 无 需 担 心 不 了 解 AspectJ 或 编写 AspectJ 切 点 表达 式 的 细节 ， 我 
们 稍 后 会 在 第 4 章 详细 地 探讨 Spring AOP 的 内 容 。 现 在 你 已 经 知道 ， 
Spring 在 骑士 执行 探险 任务 前 后 会 调用 Minstrel 的 
singBeforeQuest() 和 singAfterQuest() 方 法 ， 这 就 足够 了 。 


这 就 是 我 们 需要 做 的 所 有 的 事情 ! 通过 少量 的 XML 配置 ， 就 可 以 把 
Minstre1l 声 明 为 一 个 Spring 切面 。 如 有 果 你 现在 还 没有 完全 理解 ， 不 必 担 
心 ， 在 第 4 章 你 会 看 到 更 多 的 Spring AOP 示 例 ， 那 将 会 帮助 你 彻底 弄 清 
楚 。 现 在 我 们 可 以 从 这 个 示例 中 获得 两 个 重要 的 观点 。 


首先 ，Minstrel 仍 然 是 一 个 POJO， 没 有 任何 代码 表明 它 要 被 作为 一 个 
切面 使 用 。 当 我 们 按照 上 面 那样 进行 配置 后 ， 在 Spring 的 上 下 文 
中 ，Minstrel 实 际 上 已 经 变 成 一 个 切面 了 。 


其 次 ， 也 是 最 重要 的 ，Minstrel 可 以 被 应 用 到 BraveKnight 中 ， 
而 BraveKnight 不 需要 显 式 地 调用 它 。 实 际 上 ，BraveKnight 完 全 不 知 
道 Minstrel 的 存在 。 


必须 还 要 指出 的 是 ， 尽 管 我 们 使 用 Spring 魔法 把 Minstrel 转 变 为 一 个 切 
面 ， 但 首先 要 把 它 声 明 为 一 个 Spring bean。 能 够 为 其 他 Spring bean 做 到 
的 事情 都 可 以 同样 应 用 到 Spring 切面 中 ， 例 如 为 它们 注入 依赖 。 


应 用 切面 来 歌颂 骑士 可 能 只 是 有 点 好 玩 而 已 ， 但 是 Spring AOP 可 以 做 很 
多 有 实际 意义 的 事情 。 在 后 续 的 各 章 中 ， 你 还 会 了 解 基 于 Spring AOP 实 
现 声 明 式 事务 和 安全 (第 9 章 和 第 14 章 〉。 

但 现在 ， 让 我 们 再 看 看 Spring 简 化 Java 开 发 的 其 他 方式 。 


1.1.4 ”使 用 模板 消除 样板 式 代 码 


你 是 否 写 过 这 样 的 代码 ， 当 编写 的 时 候 总 会 感觉 以 前 曾经 这 么 写 过 ? 我 
的 朋友 ， 这 不 是 似曾相识 。 这 是 样板 式 的 代码 (boilerplate code) 。 通 
党 为 了 实现 通用 的 和 简单 的 任务 ， 你 不 得 不 一 遍 壳 地 重复 编写 这 样 的 代 
码 。 


遗憾 的 是 ， 它 们 中 的 很 多 是 因为 使 用 Java API 而 导致 的 样板 式 代码 。 样 

















板式 代码 的 一 个 常见 范例 是 使 用 JDBC 访 问 数 据 库 查 询 数据 。 举 个 例 
子 ， 如 果 你 曾经 用 过 JDBC， 那 么 你 或 许 会 写 出 类 似 下 面 的 代码 。 


ee 许多 Java API， 例 如 JDBC， 会 涉及 编写 大 量 的 样板 式 
尺码 


public Employee getEmployeeById(long id) { 
Connection conn = null; 
PreparedSstatement stmt = null; 
ResultSet rs = null; 
try { 
conn = dataSource.getConnection!(); 
stmt = conn.prepareStatement! 
"select id, firstname, lastname, salary from " + 
"employee where id=?"); 所 - 查找 员工 
stmt.setLong{1, id); 
rs = stmt.executeQuery(); 
Employee employee = null; 
if (rs.next()) { 
employee = new Employee(}); ee: 根据 数据 创建 对 象 
employee.setIid(rs.getLong("id")); 
employee.setFirstName(rs.getSstring('"firstname'")); 
employee.setLastName (lrs.getstring("lastname")); 
employee.setSalary (lrs.getBigDecimal ("salary")); 
} 


return employee:; 


} catch {SQLException e) { 亏 这 里 应 该 做 什么 ? 
} finally { 
RS wy 芯 4 清理 
try { 
rs.close(); 


} catch(SQLException e) {} 
} 
frstmt d= mL) 并 

try { 

stmt.close{); 

} catch(SQLException el {} 
} 


if(teonn l= TlL) 区 
try { 
conn.close!{); 
} catch(SQLException el {} 
} 
} 
return null; 


} 


正如 你 所 看 到 的 ， 这 段 JDBC 代 码 查 询 数 据 库 获得 员工 姓名 和 薪水 。 我 
打赌 你 很 难 把 上 面 的 代码 逐 行 看 完 ， 这 是 因为 少量 查询 员工 的 代码 淹没 
在 一 堆 JDBC 的 样板 式 代码 中 。 首 先 你 需要 创建 一 个 数据 库 连 接 ， 然 后 


再 创建 一 个 语句 对 象 ， 最 后 你 才能 进行 查询 。 为 了 平息 JDBC 可 能 会 出 
现 的 怒火 ， 你 必须 捕捉 SQLException， 这 是 一 个 检查 型 异常 ， 即 使 它 
抛 出 后 你 也 做 不 了 太 多 事情 。 


最 后 ， 毕 竟 该 说 的 也 说 了 ， 该 做 的 也 做 了 ， 你 不 得 不 清理 战场 ， 关 闭 数 
据 库 连接 、 语 句 和 结果 集 。 同 样 为 了 平 忌 JDBC 可 能 会 出 现 的 怒火 ， 你 
依然 要 捕捉 SQLException。 


程序 清单 1.12 中 的 代码 和 你 实现 其 他 JDBC 操 作 时 所 写 的 代码 几乎 是 相同 
的 。 只 有 少量 的 代码 与 查询 员工 逻辑 有 关系 ， 其 他 的 代码 都 是 JDBC 的 
样板 代码 。 

JDBC 不 是 产生 样板 式 代 人 码 的 唯一 场景 。 在 许多 编程 场景 中 往往 都 会 导 
致 类 似 的 样板 式 代 码 ，JMS、JNDI 和 使 用 REST 服 务 通常 也 涉及 大 量 的 
重复 代码 。 

Spring 则 在 通过 模板 封装 来 消除 样板 式 代 码 。Spring 的 JdbcTemplate 使 得 
执行 数据 库 操 作 时 ， 避 免 传统 的 JDBC 样 板 代码 成 为 了 可 能 。 

举 个 例子 ， 使 用 Spring 的 JdbcTemplate (利用 了 Java 5 特性 的 
JdbcTemplate 实 现 ) 重 写 的 getEmployeeById() 方 法 仅仅 关注 于 获取 
员工 数据 的 核心 逻辑 ， 而 不 需要 迎合 JDBC API 的 需求 。 程 序 清单 1.13 展 
示 了 修订 后 的 getEmployeeById() 方 法 。 


程序 清单 1.13 ”模板 能 够 让 你 的 代码 关注 于 自身 的 职责 


public Employee getEmployeeById(long id) { 








return jdbcTemplate.queryForObject ( 
"select id, firstname, lastname, salary " + < 一 SQL 查询 
"from employee where id=?", 
new RowMapper<Employee>() { 
public Employee mapRow(ResultSet rs, 
int rowNum) throws SQLException { < 将 结果 匹配 为 对 象 
Employee employee = new Employee!l(); 
employee.setid(rs.getLong ("id")); 
employee.setFirstName(rs.getstring("firstname")); 
employee.setLastName{(lrs.getstring("lastname")); 
employee.setSalary (rs.getBigDecimal ("salary")); 
return employee; 


id) ; < 一 指定 查询 参数 





正如 你 所 看 到 的 ， 新 版 本 的 getEmployeeById() 简 单 多 了 ， 而 且 仅仅 
关注 于 从 数据 库 中 查询 员工 。 模板 的 queryFor0bject() 方 法 需要 一 个 
SQL 得 询 语句 ， 一 个 RowMapper 对 象 〈 把 数据 映射 为 一 个 域 对 象 ) ， 零 
个 或 多 个 查询 参数 。GetEmp loyeeById() 方 法 再 也 看 不 到 以 前 的 
JDBC 样 板式 代码 了 ， 它 们 全 部 被 封装 到 了 模板 中 。 


我 已 经 向 你 展示 了 Spring 通过 面向 POJO 编 程 、DI、 切 面 和 模板 技术 来 简 
化 Java 开 发 中 的 复杂 性 。 在 这 个 过 程 中 ， 我 展示 了 在 基于 XML 的 配置 文 
件 中 如 何 配置 beaan 和 切面 ， 但 这 些 文件 是 如 何 加 载 的 呢 ? 它们 被 加 载 到 
让 我 们 再 了 解 下 Spring 容器 ， 这 是 应 用 中 的 所 有 bean 所 驻 留 
方 。 











1.2 ”容纳 你 的 Bean 


在 基于 Spring 的 应 用 中 ， 你 的 应 用 对 象 生存 于 Spring 容 右 (container) 
中 。 如 图 1.4 所 示 ，Spring 容 器 负责 创建 对 象 ， 装 配 它 们 ， 配 置 它们 并 管 
理 它们 的 整个 生命 周期 ， 从 生存 到 死亡 (在 这 里 ， 可 能 就 是 new 到 
finalize()) 。 





Spring 穿 器 














图 1.4 在 Spring 应 用 中 ， 对 象 由 Spring 容器 创建 和 装配 ， 并 存在 容器 之 中 


在 下 一 章 ， 你 将 了 解 如 何 配置 Spring， 从 而 让 它 知道 该 创建 、 配 置 和 组 
装 哪些 对 象 。 但 首 匈 ， 最 重要 的 是 了 解 容纳 对 象 的 容 句 。 理 解 容 器 将 有 
助 于 理解 对 象 是 如 何 被 管理 的 。 


容 右 是 Spring 框 架 的 核心 。Spring 容 器 使 用 DI 管理 构成 应 用 的 组 件 ， 它 
会 创建 相互 协作 的 组 件 之 间 的 关联 。 坚 无 疑问 ， 这 些 对 象 更 简单 干净 ， 
更 易于 理解 ， 更 易于 重用 并 且 更 易于 进行 单元 测试 。 


Spring 容 器 并 不 是 只 有 一 个 。Spring 目 带 了 多 个 容器 实现 ， 可 以 归 为 两 
种 不 同 的 类 型 。bean 工 三 

(由 org.springframework.beans.factory.BeanFactory 接 口 定 

义 ) 是 最 简单 的 容器 ， 提 供 基 本 的 DI 文 持 。 应 用 上 下 文 

(由 org.springframework.context.ApplicationContext 接 口 定 
义 ) 基于 BeanFactory 构 建 ， 并 提供 应 用 框架 级 别 的 服务 ， 例 如 从 属性 文 
件 解析 文本 信息 以 及 发 布 应 用 事件 给 感 兴趣 的 事件 监听 者 。 


里 然 我 们 可 以 在 bean 工 三 和 应 用 上 下 文 之 间 任 选 一 种 ， 但 bean 工厂 对 大 
多 数 应 用 来 说 往往 太 低 级 了 ， 因 此 ， 应 用 上 下 文 要 比 bean 工 | 更 受 欢 














迎 。 我 们 会 把 精力 集中 在 应 用 上 下 文 的 使 用 上 ， 不 再 浪费 时 间 讨 论 bean 
3 





124 “使 用 应 用 二 下文 


ee 下 面 罗列 的 几 个 是 你 最 有 可 能 过 
到 的 。 


。AnnotationConfigApplicationContext: 从 一 个 或 多 个 基于 
Java 的 配置 类 中 加 载 Spring 应 用 上 下 文 。 
e。AnnotationConfigNebApp1licationContext: 从 一 个 或 多 个 基 
于 Java 的 配置 类 中 加 载 Spring Web 应 用 上 下 文 。 
。ClassPathXmlApplicationContext: 从 类 路 径 下 的 一 个 或 多 个 
把 应 用 上 下 文 的 定义 文件 作为 
类 资源 。 
FileSystemXm1lapp1licationcontext: 从 文件 系统 下 的 一 个 或 多 
个 XML 配置 文件 中 加 载 上 下 文 定义 。 
XmlWebApplicationContext: 从 Web 应 用 下 的 一 个 或 多 个 XML 
配置 文件 中 加 载 上 下 文 定义 。 


当 在 第 8 章 讨 论 基 于 Web 的 Spring 应 用 时 ， 我 们 会 对 
AnnotationConfigWeb-ApplicationContext 和 和 
XmlwebApplicationContext 进 行 更 详细 的 讨论 。 现 在 我 们 先 简单 地 使 
用 FileSsystemXmlApplicationContext 从 文件 系统 中 加 载 应 用 上 下 文 
或 者 使 用 ClassPathXmlApp1licationContext 从 类 路 径 中 加 载 应 用 上 
下 


无 论 是 从 文件 系统 中 装载 应 用 上 下 文 还 是 从 类 路 径 下 装载 应 用 上 下 文 ， 
将 bean 加 载 到 bean 工 三 的 过 程 都 是 相似 的 。 例 如 ， 如 下 代码 展示 了 如 何 
加 载 一 个 FileSystemXmlApplicationContext: 








ApplicationContext context = new 





FileSystemXmlApplicationContext("c:/knight.xml"); 


类 似 地 ， 你 可 以 使 用 classPathXmlApplicationContext 从 应 用 的 类 
路 径 下 加 载 应 用 上 下 文 : 


ApplicationContext context = new 


ClassPathXmlApplicationContext("knight.xml"); 


使 用 FileSsystemXmlApplicationContext 和 使 用 ClassPathXmlApp- 
licationContext 的 区 别 在 

于 : FileSystemXmlApplicationContext 在 指定 的 文件 系统 路 径 下 查 
找 knight.xml 文 件 ; 而 ClassPathXmlApplicationContext 是 在 所 有 的 
类 路 径 〈 包 含 JAR 文 件 ) 下 查找 knight.xml 文 件 。 


如 果 你 想 从 Java 配 置 中 加 载 应 用 上 下 文 ， 那 么 可 以 使 
用 AnnotationConfig-ApplicationContext: 


ApplicationContext context = new AnnotationConfigApplicationContext( 


com.springinaction.knights.config.KnightConfig.class); 





在 这 里 没有 指 td 
件 ，AnnotationConfig-ApplicationContext 通 过 一 个 配置 类 加 载 
bean 。 


应 用 上 下 文 准备 就 绪 之 后 ， 我 们 束 可 以 调用 上 下 文 的 getBean() 方 法 从 
Spring 容器 中 获取 bean。 


现在 你 应 该 基本 了 解 了 如 何 创建 Spring 容器 ， 让 我 们 对 容器 中 bean 的 生 
命 周 期 做 更 进一步 的 探究 。 


1.2.2” bean 的 生命 周期 


在 传统 的 Java 应 用 中 ，bean 的 生命 周期 很 简单 。 使 用 Java 关 键 字 new 进 行 
bean 实 例 化 ， 然 后 该 bean 束 可 以 使 用 了 。 一 旦 该 bean 不 再 被 使 用 ， 则 由 
Java 目 动 进行 垃圾 回收 。 


相 比 之 下 ，Spring 容 器 中 的 bean 的 生命 周期 就 显得 相对 复杂 多 了 。 正 确 
理解 Spring bean 的 生命 周期 非常 重要 ， 因 为 你 或 许 要 利用 Spring 提供 的 
扩展 点 来 目 定 义 bean 的 创建 过 程 。 图 1.5 展 示 了 bean 装 载 到 Spring 应 用 上 
下 文中 的 一 个 典型 的 生命 周期 过 程 。 











调用 BeanName- 
Aware 的 set- 
BeanName() 方 法 () 


调用 BeanFactory- 
Aware 的 setBean- 
Factory() 方 法 


调用 ApplicationContext- 
Aware 的 setApplication- 
Context () 方 法 





































调用 BeanPost- 调用 InitializingBean 调用 自 定义 的 加 用 wo 
的 afterProperties- rocessor 
预 初始 化 方法 Set (方法 初始 化 方法 初始 化 后 方法 





Processor 的 





bean 可 以 
使 用 了 


容器 关闭 


调用 Disposable: 
调用 自 定义 的 
Bean 的 destroy() 


图 1.5 “bean 在 Spring 容器 中 从 创建 到 销毁 经 历 了 
若干 阶段 ， 每 一 阶段 都 可 以 针对 Spring 如 何 管理 bean 进 行 个 性 化 定制 


正如 你 所 见 ， 在 bean; 稚 备 束 绪 之 前 ，bean 工 厂 执 行 了 知 干 司 动 步骤 。 我 
们 对 图 1.5 进 行 详细 描述 : 


1. Spring 对 bean 进 行 实 例 化 ; 
2. Spring 将 值 和 bean 的 引用 注入 到 bean 对 应 的 属性 中 


3. 如 果 bean 实 现 了 BeanNameAware 接 口 ，Spring 将 bean 的 ID 传递 给 
setBean-Name( ) 方 法 ; 
































4. 如 果 bean 实 现 了 BeanFactoryAware 接 口 ，Spring 将 调 
用 setBeanFactory() 方 法 ， 将 BeanFactory 容 器 实例 传 入 ; 


5. 如 果 bean 实 现 了 ApplicationContextAware 接 口 ，Spring 将 调 
用 setApplicationContext() 方 法 ， 将 bean 所 在 的 应 用 上 下 文 的 引用 
传 入 进来 ; 


6. 如 果 bean 实 现 了 BeanPostProcessor 接 口 ，Spring 将 调用 它们 的 
post-ProcessBeforeInitialization() 方 法 ; 







7. 如 果 bean 实 现 了 InitializingBean 接 口 ，Spring 将 调用 它们 的 
after-PropertiesSet() 方 法 。 类 似 地 ， 如 果 bean 使 用 init-method 
声明 了 初始 化 方法 ， 访 方法 也 会 被 调用 ; 


8. 如 果 bean 实 现 了 BeanPostProcessor 接 口 ，Spring 将 调用 它们 的 
post-ProcessAfterInitialization() 方 法 ; 


9. 此 时 ，bean 已 经 准备 就 绪 ， 可 以 被 应 用 程序 使 用 了 ， 它 们 将 一 直 驻 
留 在 应 用 上 下 文中 ， 直 到 该 应 用 上 下 文 被 销毁 ; 


10. 如 果 bean 实 现 了 DisposableBean 接 口 ，Spring 将 调用 它 的 
destroy() 接 口 方法 。 同 样 ， 如 果 bean 使 用 destroy-method 声 明了 销 
贷方 法 ， 该 方法 也 会 被 调用 。 


现在 你 已 经 了 解 了 如 何 创建 和 加 载 一 个 Spring 容 占 。 但 是 一 个 空 的 容器 
并 没有 太 大 的 价值 ， 在 你 把 东西 放 进 去 之 前 ， 它 里 面 什么 都 没有 。 为 了 
从 Spring 的 DI 中 受益 ， 我 们 必须 将 应 用 对 象 装 配 进 Spring 容 嚣 中。 我们 
将 在 第 2 间 对 bean 装 配 进行 更 详细 的 探讨 。 


我 们 现在 首先 浏览 一 下 Spring 的 体系 结构 ， 了 人 解 一 下 Spring 框 染 的 基本 
组 成 部 分 和 最 新 版 本 的 Spring 所 发 布 的 新 特性 。 





1.3” 俯 隔 Spring 风景 线 


正如 你 所 看 到 的 ，Spring 框 架 关 注 于 通过 DI、AOP 和 消除 样板 式 代码 来 
简化 企业 级 Java 开 发 。 即 使 这 是 Spring 所 能 做 的 全 部 事情 ， 那 Spring 也 值 
得 一 用 。 但 是 ，Spring 实 际 上 的 功能 超 平 你 的 想象 。 


在 Spring 框架 的 范畴 内 ， 你 会 发 现 Spring 人 简化 Java 开 发 的 多 种 方式 。 但 在 
Spring 框架 之 外 还 存在 一 个 构建 在 核心 框架 之 上 的 庞大 生态 圈 ， 它 将 
Spring 扩展 到 不 同 的 领域 ， 例 如 Web 服 务 、REST、 移 动 开发 以 及 
NoSQL.。 


首先 让 我 们 拆 开 Spring 框 架 的 核心 来 看 看 它 究竟 为 我 们 带 来 了 什么 ， 然 
后 我 们 再 浏览 下 Spring Portfolio 中 的 其 他 成 员 。 


1.3.1 Spring 模块 


当 我 们 下 载 Spring 发 布 版 本 并 查看 其 lib 目 录 时 ， 会 发 现 里 面 有 多 个 JAR 
文件 。 在 Spring 4.0 中 ，Spring 框 架 的 发 布 版 本 包括 了 20 个 不 同 的 模块 ， 
每 个 模块 会 有 3 个 JAR 文 件 (二进制 类 库 、 源 码 的 JAR 文 件 以 及 JavaDoc 
的 JAR 文 件 ) 。 完 整 的 库 JAR 文 件 如 图 1.6 所 示 。 


全 全 个 Ljlibs 

Name < 
5pring-aop-4.0.0.RELEASE.jar 
spring-aspects-4.0.0.RELEASE.jar 
spring-bean5-4.0.0.RELEASE,jar 
spring-Context-4.0.0.RELEASE.jar 
spring-context-SUpport-4.0.0,RELEASE.jar 
spring-core-4.0.0.RELEASE.jar 
spring-expression-4.0.0.RELEASE.jar 
spring-instrumentr-4.0.0,RELEASE.jar 
spring-instrument-tomcat-4.0.0.RELEASE.jar 
spring-jdbc-4.0.0.RELEASE.jar 
spring-jms-4.0.0.RELEASE.jar 
spring-messaging-4.0.0.RELEASE.jar 
spring-orm-4.0.0.RELEASE.jar 
spring-oxm-4.0.0.RELEASE.jar 
spring-test-4.0.0.RELEASE.jar 
Spring-tX-4.0.0.RELEASE.jar 
spring-web-4.0.0.RELEASE.jar 
spring-webmvc-4,0,0,.RELEASE.jar 
spring-webmvc-portlet-4.0.0.RELEASE.jar 
spring-websocket-4,0.0.RELEASE,jar 


i By 


ho ho hu hu ho 


bebo wlle hw ho) helhi) hu hy 


图 1.6 Spring 框 架 由 20 个 不 同 的 模块 组 成 
这 些 模 块 依据 其 所 属 的 功能 可 以 划分 为 6 类 不 同 的 功能 ， 如 图 1.7 所 示 。 


忆 体 而 言 ， 这 些 模块 为 开发 企业 级 应 用 提供 了 所 需 的 一 切 。 但 是 你 也 不 
必 将 应 用 建立 在 整个 Spring 框 染 之 上 ， 你 可 以 自由 地 选择 适合 自身 应 用 

需求 的 Spring 模 块 ， 当 Spring 不 能 满足 需求 时 ， 完 全 可 以 考虑 其 他 选 

择 。 事 实 上 ，Spring 其 至 提供 了 与 其 他 第 三 方 框架 和 类 库 的 集成 吧 ， 这 

样 你 就 不 需要 上 自己 编写 这 样 的 代码 了 。 
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图 1.7 ” Spring 框架 由 6 个 定义 良好 的 模块 分 类 组 成 


A 看 看 它们 是 如 何 构 建 起 Spring 整 体 蓝图 


Spring 核 心 容 右 


容器 是 Spring 框 架 最 核心 的 部 分 ， 它 管理 着 Spring 应 用 中 bean 的 创建 、 
配置 和 管理 。 在 该 模块 中 ， 包 括 了 Spring bean 工 厂 ， 它 为 Spring 提供 了 
DI 的 功能 。 基 于 bean 工 厂 ， 我 们 还 会 友 现 有 多 种 Spring 应 用 上 下 文 的 实 
现 ， 每 一 种 都 提供 了 配置 Spring 的 不 同方 式 。 


除了 bean 工 三 和 应 用 上 上 下文， 该 模块 也 提供 了 许多 企业 服务 ， 例 如 E- 
mail、JNDI 访 问 、EJB 集 成 和 调度 。 


所 有 的 Spring 模块 都 构建 于 核心 容器 之 上 。 当 你 配置 应 用 时 ， 其 实 你 隐 
式 地 使 用 了 这 些 类 。 贯 穿 本 书 ， 我 们 都 会 涉及 到 核心 模块 ， 在 第 2 章 中 
我 们 将 会 深入 探讨 Spring 的 DI。 


Spring 的 AOP 模 块 





在 AOP 模 块 中 ，Spring 对 面向 切面 编程 提供 了 丰富 的 支持。 这 个 模块 是 
Spring 应 用 系统 中 开发 切面 的 基础 。 与 DI 一 样 ，AOP 可 以 帮助 应 用 对 象 
解 灰 。 借 助 于 AOP， 可 以 将 过 布 系统 的 关注 点 《例如 事务 和 安全 ) 从 它 
们 所 应 用 的 对 象 中 解 丰 出 来 。 


我 们 将 在 第 4 章 深 入 探讨 Spring 对 AOP 支 持 。 
数据 访问 与 集成 


使 用 JDBC 编 写 代 人 码 通 常会 导致 大 量 的 样板 式 代码 ， 例 如 获得 数据 库 连 
接 、 创 建 语句 、 处 理 结 果 集 到 最 后 关闭 数据 库 连 接 。Spring 的 JDBC 和 

DAO (Data Access Object) 模块 抽象 了 这 些 样 板式 代码 ， 使 我 们 的 数据 
库 代码 变 得 简单 明了 ， 还 可 以 避免 因为 天 闭 数据 库 资源 失败 而 引发 的 问 
题 。 该 模块 在 多 种 数据 库 服务 的 错误 信息 之 上 构建 了 一 个 语义 丰富 的 异 
常 层 ， 以 后 我 们 再 也 不 需要 解释 那些 隐 具 专 有 的 SQL 错误 信息 了 ! 


对 于 那些 更 喜欢 ORM (ObjectrRelational Mapping) 工具 而 不 愿意 直接 
使 用 JDBC 的 开发 者 ，Spring 提 供 了 ORM 模 块 。Spring 的 ORM 模 块 建立 
在 对 DAO 的 支持 之 上 ， 并 为 多 个 ORM 框 架 提 供 了 一 种 构建 DAO 的 简便 
方式 。Spring 没 有 尝试 去 创建 自己 的 ORM 人 解决 方 案 ， 而 是 对 许多 流行 的 
ORM 框 架 进 行 了 和 集成， 包括 Hibernate、Java Persisternce API、Java Data 
Object 和 iBATIS SQL Maps。Spring 的 事务 管理 支持 所 有 的 ORM 框 架 以 
及 JDBC。 


在 第 10 章 讨论 Spring 数据 访问 时 ， 你 会 看 到 Spring 基于 模板 的 JDBC 抽 象 
层 能 够 极 大 地 简化 JDBC 代 码 。 

本 模块 同样 包含 了 在 JMS (Java Message Service) 之 上 构建 的 Spring 抽 
象 屋 ， 它 会 使 用 消 恕 以 异步 的 方式 与 其 他 应 用 集成 。 从 Spring 3.0 开 始 ， 
本 模块 还 包含 对 象 到 XML 映射 的 特性 ， 它 最 初 是 Spring Web Service 项 
目的 一 部 分 。 


除 此 之 外 ， 本 模块 会 使 用 Spring AOP 模 块 为 Spring 应 用 中 的 对 象 提供 事 
务 管理 服务 。 


Web 与 远程 调用 


MVC (Model-View-Controller) 模式 是 一 种 普 裔 被 接受 的 构建 Web 应 用 

















的 方法 ， 它 可 以 帮助 用 户 将 界面 逻辑 与 应 用 逻辑 分 离 。Java 从 来 不 缺少 
MVC 框 架 ，Apache 的 Struts、JSF、WebWork 和 Tapestry 都 是 可 选 的 最 流 
行 的 MVC 框 架 。 


虽然 Spring 能 够 与 多 种 流行 的 MVC 框 架 进行 集成 ， 但 它 的 Web 和 远程 调 
用 模块 自 带 了 一 个 强大 的 MVC 框 架 ， 有 助 于 在 web 层 提升 应 用 的 松 耦 合 
水 平 。 在 第 5 章 到 第 7 章 中 ， 我 们 将 会 学 习 Spring 的 MVC 框 架 。 


除了 面向 用 户 的 Web 应用， 该 模块 还 提供 了 多 种 构建 与 其 他 应 用 交互 的 
远程 调用 方案 。Spring 远 程 调用 功能 集成 了 RMI (Remote Method 
Invocation ) 、Hessian、Burlap、JAX-WS， 同 时 Spring 还 目 带 了 一 个 远 
程 调用 框架 : HTTP invoker。Spring 还 提供 了 暴露 和 使 用 REST API 的 良 
好 文 持 。 


我 们 将 会 在 第 15 章 讨论 Spring 的 远程 调用 功能 。 在 第 16 章 学 习 如 何 创建 
和 使 用 REST API。 








Instrumentation 


Spring 的 Instrumentation 模 块 提供 了 为 JVM 添 加 代理 (agent) 的 功能 。 具 
体 来 讲 ， 它 为 Tomcat 提 供 了 一 个 织 入 代理 ， 能 够 为 Tomcat 传 递 类 文件 ， 
惑 像 这 些 文件 是 被 类 加 载 器 加 载 的 一 样 。 


如 果 这 上 听 起 来 有 点 难以 理解 ， 不 必 对 此 过 于 担心 。 这 个 模块 所 提供 的 
Instrumentation 使 用 场景 非常 有 限 ， 在 本 书 中 ， 我 们 不 会 介绍 该 模块 。 
测试 

发 者 自 测 的 重要 性 ，Spring 提 供 了 测试 模块 以 致力 于 Spring 应 用 
和 测试 。 


通过 该 模块 ， 你 会 发 现 Spring 为 使 用 JNDI、Servlet 和 Portlet 编 写 单 元 测 
试 提 供 了 一 系列 的 mock 对 象 实现 。 对 于 集成 测试 ， 该 模块 为 加 载 Spring 
应 用 上 下 文中 的 bean 集 合 以 及 与 Spring 上 下 文中 的 bean 进 行 交 互 提供 了 


文 持 。 


在 本 书 中 ， 有 很 多 的 样 例 都 是 测试 驱动 的 ， 将 会 使 用 到 Spring 所 提供 的 
测试 功能 。 











1.3.2 ”Spring Portfolio 


当 谈 论 Spring 时 ， 其 实 它 远 远 超出 我 们 的 想象 。 事 实 上 ，Spring 远 不 是 
Spring 框架 所 下 载 的 那些 。 如 果 仅 仅 停 留 在 核心 的 Spring 框架 层面 ， 我 
们 将 错过 Spring Portfolio 所 提供 的 巨额 财富 。 整 个 Spring Portfolio 包 括 多 
个 构建 于 核心 Spring 框架 之 上 的 框架 和 类 库 。 概 括 地 讲 ， 整 个 Spring 
Portfolio 几 乎 为 每 一 个 领域 的 Java 开 发 都 提供 了 Spring 编程 模型 。 


或 许 需 要 几 卷 书 才能 履 盖 Spring Portfolio 所 提供 的 所 有 内 容 ， 这 也 远 远 
超出 了 本 书 的 范围 。 不 过 ， 我 们 会 介绍 Spring Portfolio 中 的 一 些 项 目 ， 
同样 ， 我 们 将 体验 一 下 核心 框架 之 外 的 另 一 番 风 景 。 








Spring Web Flow 


Spring Web Flow 建 立 于 Spring MVC 框 架 之 上 ， 它 为 基于 流程 的 会 话 式 
Web 应 用 (可 以 想 一 下 购物 车 或 者 回 导 功能 ) 提供 了 文 持 。 我 们 将 在 第 
8 章 讨论 更 多 关于 Spring Web Flow 的 内 容 ， 你 还 可 以 访问 Spring Web 
Flow 的 主页 (http://projects.spring.io/spring-webflow/) 。 


Spring Web Service 


虽然 核心 的 Spring 框架 提供 了 将 Spring bean 以 声明 的 方式 发 布 为 Web 
Service 的 功能 ， 但 是 这 些 服 务 是 基于 一 个 具有 争议 性 的 架构 〈 拙 劣 的 契 
约 后 置 模型 ) 之 上 而 构建 的 。 这 些 服务 的 契约 由 bean 的 接口 来 决定 。 
Spring Web Service 提 供 了 契约 优先 的 Web Service 模 型 ， 服 务 的 实现 都 是 
为 了 满足 服务 的 契约 而 编写 的 。 


本 书 不 会 再 探讨 Spring Web Service， 但 是 你 可 以 浏览 站 点 
http://docs.spring.io/spring- ws/site/ 来 了 解 更 多 关于 Spring Web Service 的 
兰 自 


百 vEo 








Spring Security 


安全 对 于 许多 应 用 都 是 一 个 非常 关键 的 切面 。 利 用 Spring AOP，Spring 
Security 为 Spring 应 用 提供 了 声明 式 的 安全 机 制 。 你 将 会 在 第 9 章 看 到 如 
何 为 应 用 的 Web 层 添加 Spring Security 功 能 。 同 时 ， 我 们 还 会 在 第 14 章 重 
新 回 到 Spring Security 的 话题 ， 学 习 如 何 保护 方法 调用 。 你 可 以 在 主 

页 http://projects.spring.io/spring-security/ 上 获得 关于 Spring Security 的 更 多 





信息 


上 Jo 
Spring Integration 


许多 企业 级 应 用 都 需要 与 其 他 应 用 进行 交互 。Spring Integration 提 供 了 
多 种 通用 应 用 集成 模式 的 Spring 声明 式 风 格 实现 。 


我 们 不 会 在 本 书 履 盖 Spring Integration 的 内 容 ， 但 是 如 果 你 想 了 解 更 多 
关于 Spring Integration 的 信息 ， 我 推荐 Mark Fisher、Jonas Partner、 
Marius Bogoevici 和 Iwein Fuld 编 写 的 《Spring Integration in Action》 
CManning，2012，www.manning.comyfishev) ; 或 者 你 还 可 以 访问 
Spring Integration 的 主页 http://projects.spring.io/spring-integration/。 


Spring Batch 


当 我 们 需要 对 数据 进行 大 量 操作 时 ， 0 
这 种 场景 。 如 果 需 要 开发 一 个 批 处 理应 用 ， 你 可 以 通过 Spring Batch， 
使 用 Spring 强大 的 面向 POJO 的 编程 模型 。 


Spring Batch 超 出 了 本 书 的 范畴 ， 但 是 你 可 以 阅读 Arnaud Cogoluegnes、 
Thierry Templier、Gary Gregory 和 Olivier Bazoud 编 写 的 《Spring Batch in 
Action》 (Manning，2012，www.manning.com/templier/) ， 或 者 访问 
Spring Batch 的 主页 http://projects.spring.io/ Spring-batchy。 


Spring Data 


Spring Data 使 得 在 Spring 中 使 用 任何 数据 库 都 变 得 非常 容易 。 尽 管 关系 

型 数据 库 统 治 企业 级 应 用 多 年 ， 但 是 现代 化 的 应 用 正在 认识 到 并 不 是 所 
有 的 数据 都 适合 放 在 一 张 表 中 的 行 和 列 中 。 一 种 新 的 数据 库 种 类 ， 通 常 
被 称 之 为 NoSQL 数 据 库 中 ， 0 这 些 方法 会 比 传 
统 的 关系 型 数据 库 更 为 合 


不 管 你 使 用 文档 数据 库 ， 如 MongoDB， 图 数据 库 ， 如 Neo4j， 还 是 传统 
的 关系 型 数据 库 ，Spring Data 都 为 持久 化 提供 了 一 种 人 
这 包括 为 多 种 数据 库 类 型 提供 了 一 种 自动 化 的 Repository 机 制 ， 它 负责 

为 你 创建 Repository 的 实现 。 


我 们 将 会 在 第 11 章 看 到 如 何 使 用 Spring Data 位 化 Java Persistence 








API (JPA) 开发 ， 然 后 在 第 12 章 ， 将 相关 的 讨论 拓展 至 几 种 NoSQL 数 
据 库 。 


Spring Social 


社交 网 络 是 互联 网 领域 中 新 兴 的 一 种 潮流 ， 越 来 越 多 的 应 用 正在 融入 社 
区 网 络 网 站 ， 例 如 Facebook 或 者 Twitter。 如 果 对 此 感 兴趣 ， 你 可 以 了 解 
一 下 Spring Social， 这 是 Spring 的 一 个 社交 网 络 扩展 模块 。 


不 过 ，Spring Social 并 不 仅仅 是 tweet 和 和 好友。 尽管 名 字 是 这 样 ， 但 
Spring Social 更 多 的 是 关注 连接 (connect) ， 而 不 是 社交 (social) 。 它 

能 够 帮助 你 通过 REST API 连 接 Spring 应 用 ， 其 中 有 些 Spring 应 用 可 能 原 
本 并 没有 任何 社交 方面 的 功能 目标 。 


限于 篇 幅 ， 我 们 在 本 书 中 不 会 涉 步 及 Spring Social。 但 是 ， 如 果 你 对 Spring 
如 何 帮 助 你 连接 Facebook 或 Twitter 感 兴趣 的 话 ， 可 以 查看 网 

址 https://spring.io/guides/gs/accessing- facebook/ 和 
https://spring.io/guides/gs/accessing-twitter/ 中 的 入 门 指南 。 











Spring Mobile 


移动 应 用 是 男 一 个 引 人 瞩 目的 软件 开发 领域 。 知 能 手机 和 平板 设备 已 成 
为 许多 用 户 首 选 的 客户 端 。Spring Mobile 是 Spring MVC 新 的 扩展 模块 ， 
用 于 支持 移动 Web 应 用 开发 。 


Spring for Android 


与 Spring Mobile 相 关 的 是 Spring Android 项 目 。 这 个 新 项 目 ， 旨 在 通过 
Spring 框架 为 开发 基于 Android 设 备 的 本 地 应 用 提供 某 些 简 单 的 文 持 。 最 
初 ， 这 个 项 目 提 供 了 Spring RestTemplate 的 一 个 可 ee 
之 中 ws 它 还 能 与 Spring Social 协 作 ， 使 得 原生 应 用 可 以 通过 REST 
API 进 行 社交 网 络 的 连接 。 


本 书 中 ， 我 不 会 讨论 Spring for Android， 不 过 你 可 以 通过 
http://projects.spring.io /spring-android/ 了解 更 多 内 容 。 


Spring Boot 
Spring 极 大 地 简化 了 众多 的 编程 任务 ， 减 少 甚至 消除 了 很 多 样板 式 代 


码 ， 如 果 没 有 Spring 的 话 ， 在 日 名 工作 中 你 不 得 不 编写 这 样 的 样板 代 
人 码 。Spring Boot 是 一 个 箔 新 的 令 人 兴奋 的 项 目 ， 它 以 Spring 的 视角 ， 致 
力 于 简化 Spring 本 身 。 

Spring Boot 大 量 依赖 于 自动 配置 技术 ， 它 能 够 消除 大 部 分 《在 很 多 场景 
中 ， 甚 至 是 全 部 ) Spring 配置 。 它 还 提供 了 多 个 Starter 项 目 ， 不 管 你 使 
用 Maven 还 是 Gradle， 这 都 能 减少 Spring 工程 构建 文件 的 大 小 。 


在 本 书 即 将 结束 的 第 21 章 ， 我 们 将 会 学 习 Spring Boot。 





1.4 Spring 的 新 功能 


当 本 书 的 第 3 版 交付 印刷 的 时 候 ， 当 时 Spring 的 最 新 版 本 是 3.0.5。 那 大 约 
是 在 3 年 前 ， 从 那 时 到 现在 发 生 了 很 多 的 变化 。Spring 框 架 经 历 了 3 个 重 
要 的 发 布 版 本 一 一 3.1、3.2 以 及 现在 的 4.0 一 一 每 个 版 本 都 带 来 了 新 的 特 
性 和 增强 ， 以 简化 应 用 程序 的 研发 。Spring Portfolio 中 的 一 些 成 员 项 目 

也 经 历 了 重要 的 变更 。 


本 书 也 进行 了 更 新 ， 试 图 涵盖 这 些 发 布 版 本 中 众多 最 令 人 兴奋 和 有 用 的 
特性 。 但 现在 ， 我 们 移 简 要 地 了 解 一 下 Spring 带 来 了 哪些 新 功能 。 














1.4.1 Spring 3.1 新 特性 


Spring 3.1 带 来 了 多 项 有 用 的 新 特性 和 增强 ， 其 中 有 很 多 都 是 关于 如 何 简 
化 和 改善 配置 的 。 除 此 之 外 ，Spring 3.1 还 提供 了 声明 式 缓存 的 支持 以 及 
MVC 的 功能 增强 。 下 面 的 列表 展现 了 Spring 3.1 重 要 的 
功能 升级 : 


。 为 了 解决 各 种 环境 下 《如 开发 、 测 试 和 生产 ) 选择 不 同 配置 的 问 
题 ，Spring 3.1 引 入 了 环境 profile 功 能 。 借 助 于 profile， 就 能 根据 应 
用 部 灵 在 什么 环境 之 中 选择 不 同 的 数据 源 bean 

在 Spring 3.0 基 于 Java 的 配置 之 上 ，Spring 3.1 添 加 了 多 个 enable 注 
解 ， 这 样 就 能 使 用 这 个 注解 局 用 Spring 的 特定 功能 ; 

添加 了 Spring 对 声明 式 缓存 的 文 持 ， 能 够 使 用 简单 的 注解 声明 缓存 
边界 和 规则 ， 这 与 你 以 前 声明 事务 边界 很 类 似 ; 

新 添加 的 用 于 构造 器 注入 的 c 命 名 空间 ， 它 类 似 于 Spring 2.0 所 提供 
的 面 同 属性 的 p 命 名 空间 ，p 命 名 空间 用 于 属性 注入 ， 它 们 都 是 非常 
简洁 易 用 的 ; 

Spring 开始 文 持 Servlet 3.0， 包 括 在 基于 Java 的 配置 中 声明 Servlet 和 
Filter， 而 不 再 借助 于 web.xml; 

改善 Spring 对 JPA 的 支持 ， 使 得 它 能 够 在 Spring 中 完整 地 配置 JPA， 
不 必 再 使 用 persistence.xml 文 件 。 


Spring 3.1 还 包含 了 多 项 针对 Spring MVC 的 功能 增强 : 


。 目 动 绑 定 路 径 变 量 到 模型 属性 中 ; 











。 提供 了 Q@RequestMappingproduces 和 consumes 属 性 ， 用 于 匹配 请 
求 中 的 Accept 和 Content -Type 头 部 信息 ; 

。 提供 了 @RequestPart 注 解 ， 用 于 将 multipart 请 求 中 的 某 些 部 分 绑 
定 到 处 理 占 的 方法 参数 中 ; 

。 支持 Flash 属 性 (在 redirect 请 求 之 后 依然 能 够 存活 的 属性 ) 以 及 用 
于 在 请 求 间 存放 flash 属 性 的 RedirectAttributes 类 型 。 


除了 Spring 3.1 所 提供 的 新 功能 以 外 ， 同 等 重要 的 是 要 注意 Spring 3.1 不 
再 支持 的 功能 。 具 体 来 讲 ， 为 了 支持 原生 的 EntityManager，Spring 的 
JpaTemplate 和 JpaDaoSupport 类 被 废弃 掉 了 。 尽 管 它们 已经 被 废弃 
了 ， 但 直到 Spring 3.2 版 本 ， 它 依然 是 可 以 使 用 的 。 但 最 好 不 要 再 使 用 它 
人 因为 它们 不 会 进行 更 新 以 支持 JPA 2.0， 并 且 已 经 在 Spring 4 中 移 
除 。 


现在 ， 让 我 们 看 一 下 Spring 3.2 提 供 了 什么 新 功能 。 











1.4.2 ”Spring 3.2 新 特性 


Spring 3.1 在 很 大 程度 上 聚焦 于 配置 改善 以 及 其 他 的 一 些 增强 ， 包 括 
Spring MVC 的 增强 ， 而 Spring 3.2 是 主要 关注 Spring MVC 的 一 个 发 布 版 
本 。Spring MVC 3.2 市 来 了 如 下 的 功能 提升 : 


。 Spring 3.2 的 控制 器 (Controller〉 可 以 使 用 Servlet 3.0 的 异步 请 求 ， 
允许 在 一 个 独立 的 线程 中 处 理 请 求 ， 从 而 将 Servlet 线 程 解放 出 来 处 
理 更 多 的 请 求 ; 

。 尽管 从 Spring 2.5 开 始 ，Spring MVC 控 制 器 就 能 以 POJO 的 形式 进行 
很 便利 地 测试 ， 但 是 Spring 3.2 引 入 了 Spring MVC 测 试 框架 ， 用 于 
为 控制 器 编写 更 为 丰富 的 测试 ， 断 言 它 们 作为 控制 器 的 行为 行为 是 
侍 正 确 ， 而 且 在 使 用 的 过 程 中 并 不 需要 Servlet 容 器 ; 

。 除了 提升 控制 器 的 测试 功能 ，Spring 3.2 还 包含 了 基于 
RestTemplate 的 客户 端的 测试 文 持 ， 在 测试 的 过 程 中 ， 不 需要 往 
真正 的 REST 端 点 上 发 送 请 求 ; 

。@ControllerAdvice 注 解 能 够 将 通用 的 @ExceptionHandler、@ 
InitBinder 和 @ModelAttributes 方 法 收集 到 一 个 类 中 ， 并 应 用 
到 所 有 控制 器 上 ; 

。 在 Spring 3.2 之 前 ， 只 能 通过 ContentNegotiatingViewResolver 
使 用 完整 的 内 容 协商 〈full content negotiation ) 功能 。 但 是 在 Spring 











3.2 中 ， 完 整 的 内 容 协 商 功能 可 以 在 整个 Spring MVC 中 使 用 ， 即 便 
是 依赖 于 消息 转换 器 〈message converter) 使 用 和 产生 内 容 的 控制 
器 方法 也 能 使 用 该 功能 ; 

。 Spring MVC 3.2 包 含 了 一 个 新 的 @MatrixVariable 注 解 ， 这 个 注解 
0 (matrix variable) 绑 定 到 处 理 堪 的 方法 参 


。 基础 的 抽象 类 AbstractDispatcherServletInitializer 能 够 非 
常 便利 地 配置 DispatcherServlet， 而 不 必 再 使 用 web.xml。 与 之 
类 似 ， 当 你 希望 通过 基于 Java 的 方式 来 配置 Spring 的 时 候 ， 可 以 使 
用 Abstract- Annotat 
ionConfigDispatcherServletInitializer 的 子 类 ; 

。 新 增 了 ResponseEntityExceptionHandler， 可 以 用 来 奉 代 
Default- HandlerException 
Resolver。ResponseEntityExceptionHandler 方 法 会 返回 
ResponseEntity<ObJject>， 而 不 是 ModelAndView; 

。 RestTemplate 和 @RequestBody 的 参数 可 以 支持 范 型 ; 

。 RestTemplate 和 @RequestMapping 可 以 支持 HTTP PATCH 方法 ; 

。 人 文 持 使 用 URL 模 式 将 其 排除 在 拦截 器 的 处 理 功 能 
XP 


虽然 Spring MVC 是 Spring 3.2 改 善 的 核心 内 容 ， 但 是 它 依然 还 增加 了 多 
项 非 MVC 的 功能 改善 。 下 面 列 出 了 Spring 3.2 中 几 项 最 为 有 意思 的 新 特 
性 : 


。 OAutowired、Q@VvValue 和 @Bean 注 解 能 够 作为 元 注解 ， 用 于 创建 自 
定义 的 注入 和 bean 声 明 注解 ; 

。 QDateTimeFormat 注 解 不 再 强 依 赖 JodaTime。 如 果 提 供 了 
JodaTime， 束 会 使 用 它 ， 否 则 的 话 ， 会 使 用 simpleDateFormat:; 

。 Spring 的 声明 式 绥 存 提供 了 对 JCache 0.5 的 支持 ; 

。 文 持 定 义 全 局 的 格式 来 解析 和 演 染 日 期 与 时 间 ; 

。 在 集成 测试 中 ， 能 够 配置 和 加 载 NebApplicationContext; 

。 在 集成 测试 中 ， 能 够 针对 request 和 session 作 用 域 的 bean 进 行 测试 。 


在 本 书 的 多 个 章节 中 ， 都 能 看 到 Spring 3.2 的 特性 ， 尤 其 是 在 Web 和 
REST 相 关 的 章节 中 。 




















1.4.3 Spring 4.0 新 特性 


当 编 写本 书 时 ，Spring 4.0 是 最 新 的 发 布 版 本 。 在 Spring 4.0 中 包含 了 很 
多 令 人 兴奋 的 新 特性 ， 包 括 : 


Spring 提供 了 对 WebSocket 编 程 的 文 持 ， 包 括 文 持 JSR-356 
API for WebSocket; 

鉴于 WebSocket 仪 仅 提供 了 一 种 低层 次 的 API， 和 急需 高 层次 的 抽 
象 ， 因 此 Spring 4.0 在 WebSocket 之 上 提供 了 一 个 高 层次 的 面 癌 消息 
的 网 程 模型 ， 该 模型 基于 SockJS， 并 且 包 含 了 对 STOMP 协 议 的 文 


持 ; 

新 的 消息 (messaging) 模块 ， 很 多 的 类 型 来 源 于 Spring Integration 
项 目 。 这 个 消息 模块 支持 Spring 的 SockJS/STOMP 功 能 ， 同 时 提供 
了 基于 模板 的 方式 发 布 消息 ; 

Spring 是 第 一 批 ( 如 果 不 说 是 第 一 个 的 话 ) 文 持 Java 8 特性 的 Java 框 
架 ， 比 如 它 所 支持 的 lambda 表 达 式 。 别 的 暂且 不 说 ， 这 首先 能 够 让 
使 用 特定 的 回调 接口 〈 如 RowMapper 和 JdbcTemplate) 更 加 简 
洁 ， 代 码 更 加 易 读 ; 

与 Java 8 同时 得 到 支持 的 是 JSR-310 一 一 Date 与 Time API， 在 处 理 日 
期 和 时 间 时 ， 它 为 开发 者 提供 了 比 java.util.Date 

或 java.util.Calendar 更 丰富 的 API; 

为 Groovy 开 发 的 应 用 程序 提供 了 更 加 顺畅 的 编程 体验 ， 尤 其 是 文 持 
非常 便利 地 完全 采用 Groovy 开 发 Spring 应 用 程序 。 随 这 些 一 起 提供 
的 是 来 自 于 Grails 的 BeanBuilder， 借 助 它 能 够 通过 Groovy 配 置 
Spring 心 用 ; 

添加 了 条 件 化 创建 bean 的 功能 ， 在 这 里 只 有 开发 人 员 定 义 的 条 件 满 
足 时 ， 才 会 创建 所 声明 的 bean; 

Spring 4.0 包 含 了 Spring RestTemplate 的 一 个 新 的 异步 实现 ， 它 会 
立即 返回 并 且 人 允许 在 操作 完成 后 执行 回调 ; 

添加 了 对 多 项 JEE 规 范 的 支持 ， 包 括 JMS 2.0、JTA 1.2、JPA 2.1 和 
Bean Validation 1.1。 


Java 




















可 以 看 到 ， 在 Spring 框架 的 最 新 发 布 版 本 中 ， 包 含 了 很 多 令 人 兴奋 的 新 
特性 。 在 本 书 中 ， 我 们 将 会 看 到 很 多 这 样 的 新 特性 ， 同 时 也 会 学 习 
Spring 中 长 期 以 来 一 直 存 在 的 特性 。 





1.5 ”小结 


现在 ， 你 应 该 对 Spring 的 功能 特性 有 了 一 个 清晰 的 认识 。Spring 致 力 于 
简化 企业 级 Java 开 发 ， 促 进 代 码 的 松散 耦合 。 成 功 的 关键 在 于 依赖 注入 
和 AOP。 


在 本 章 ， 我 们 先 体验 了 Spring 的 DI。DI 是 组 装 应 用 对 象 的 一 种 方式 ， 借 
助 这 种 方式 对 象 无 需 知 着 依赖 来 目 何 处 或 者 依赖 的 实现 方式 。 不 同 于 目 
己 获取 依赖 对 象 ， 对 象 会 在 运行 期 赋予 它们 所 依赖 的 对 象 。 依 赖 对 象 通 
常会 通过 接口 了 解 毛 注入 的 对 象 ， 这 样 的 话 就 能 确保 低 耦 合 。 


除了 DI， 我 们 还 简单 介绍 了 Spring 对 AOP 的 支持 。AOP 可 以 帮助 应 用 将 
散落 在 各 处 的 逻辑 汇集 于 一 处 一 一 切面 。 当 Spring 装 配 bean 的 时 候 ， 这 
些 切面 能 够 在 运行 期 编织 起 来 ， 这 样 就 能 非常 有 效 地 赋予 bean 新 的 行 














依赖 注入 和 AOP 是 Spring 框架 最 核心 的 部 分 ， 因 此 只 有 理解 了 如 何 应 用 
Spring 最 关键 的 功能 ， 你 才 有 能 力 使 用 Spring 框架 的 其 他 功能 。 在 本 
章 ， 我 们 只 是 触及 了 Spring DI 和 AOP 特 性 的 皮毛 。 在 以 后 的 几 章 ， 我 们 
将 深入 探讨 DI 和 AOP。 


闲 言 少 哲 ， 我 们 立即 转 到 第 2 章 学 习 如 何在 Spring 中 使 用 DI 淡 配 对象。 





[1] 对 于 基于 Java 的 配置 ，Spring 提 供 了 


AnnotationConfigApplicationContext。 


[2] 相 对 于 NoSQL， 我 更 喜欢 非 关 系 型 Cnon-relational ) 或 无 模式 
(schema-less) 这 样 的 术语 。 将 这 些 数据 库 称 之 为 NoSQL， 实 际 上 将 问 
题 归 因 于 查询 语言 ， 而 不 是 数据 模型 。 








声明 bean 

构造 器 注入 和 Setter 方 法 注入 
装配 bean 

控制 bean 的 创建 和 销毁 


在 看 电影 的 时 候 ， 你 曾经 在 电影 结束 后 留 在 位 置 上 继续 观看 片尾 字 闫 

吗 ? 一 部 电影 需要 由 这 么 多 人 齐心 协力 才能 制作 出 来 ， 这 真是 有 点 令 人 
难以 置信 ! 除了 主要 的 参与 人 员 一 一 演员 、 编 剧 、 导 演 和 制 上 语 人， 还 有 
那些 硕 后 人 员 一 一 普 乐 师 、 特 效 制作 人 员 和 艺术 指导 ， 更 不 用 说 道具 

师 、 录 首 师 、 服 装 师 、 化 妆 师 、 特 技 演 员 、 广 告 师 、 第 一 助理 摄影 师 、 
RD 

1 于 


现在 想象 一 下 ， 如 果 这 些 人 彼此 之 间 没 有 任何 交流 ， 你 最 襄 爱 的 电影 会 
变 成 什么 样子 ?让 我 这 么 说 吧 ， 他 们 都 出 现在 摄影 棚 中 ， 开 始 各 做 各 的 
事情 ， 彼 此 之 间 互 不 合作 。 如 末 导 演 保 持 沉 默 不 喊 “ 开 机 ”， 摄 影 师 束 不 
会 开始 担 握 。 或 许 这 并 没什么 大 不 了 的 ， 因 为 女 主角 还 未 在 她 的 保姆 车 
里 ， 而 且 因为 没有 雇佣 灯光 师 ， 一 切 处 于 黑暗 之 中 。 或 许 你 曾经 看 过 类 
似 这 样 的 电影 。 但 是 大 多 数 电影 〈 总 之 ， 都 还 是 很 优秀 的 ) 都 是 由 成 干 
a i 
和 佳作 。 


在 这 方面 ， 一 个 优秀 的 软件 与 之 相 比 并 没有 太 大 区 别 。 任 何 一 个 成 功 的 
应 用 都 是 由 多 个 为 了 实现 某 一 个 业务 目标 而 相互 协作 的 组 件 构成 的 。 这 
些 组 件 必须 彼此 了 解 ， 并 且 相 互 协 作 来 完成 工作 。 例 如 ， 在 一 个 在 线 购 
物 系统 中 ， 订 单 管 理 组 件 需要 和 产品 管理 组 件 以 及 信用 卡 认证 组 件 协 
作 。 这 些 组 件 或 许 还 需要 与 数据 访问 组 件 协作 ， 从 数据 库 读 取 数据 以 及 
把 数据 写 入 数据 库 。 


但 是 ， 正 如 我 们 在 第 1 革 中 所 看 到 的 ， 创 建 应 用 对 象 之 间 关 联 关 系 的 传 
统 方法 (通过 构造 器 或 者 但 找 ) 通常 会 导致 结构 复杂 的 代码 ， 这 些 代 码 






































很 难 被 复 用 也 很 难 进行 单元 测试 。 如 果 情 况 不 严重 的 话 ， 这 些 对 象 所 做 
的 事情 只 是 超出 了 它 应 该 做 的 范围 ， 而 最 坏 的 情况 则 是 ， 这 些 对 象 彼此 
之 间 高 度 碍 合 ， 难 以 复 用 和 测试 。 


在 Spring 中 ， 对 象 无 需 自己 查找 或 创建 与 其 所 关联 的 其 他 对 象 ， 相 反 ， 
容器 负责 把 需要 相互 协作 的 对 象 引用 赋予 各 个 对 象 。 例 如 ， 一 个 订单 管 
理 组 件 需要 信用 卡 认证 组 件 ， 但 它 不 需要 自己 创建 信用 卡 认证 组 件 。 订 
单 管理 组 件 只 需要 表明 自己 两手 空 宅 ， 容 吕 就 会 主 开 卫 它 一 个 信用 上 
WULs o 


创建 应 用 对 象 之 间 协 作 关 系 的 行为 通常 称 为 装配 (wiring) ， 这 也 是 依 
赖 注 入 (DI) 的 本 质 。 在 本 章 我 们 将 介绍 使 用 Spring 装配 bean 的 基础 知 
识 。 因 为 DI 是 Spring 的 最 基本 要 素 ， 所 以 在 开发 基于 Spring 的 应 用 时 ， 
你 随时 都 在 使 用 这 些 技术 。 


在 Spring 中 装配 bean 有 多 种 方式 。 作 为 本 章 的 开始 ， 我 们 先 花 一 点 时 间 
来 介绍 一 下 配置 Spring 容 器 最 常见 的 三 种 方法 。 


























2.1 Spring 配置 的 可 选 方案 


如 第 1 章 中 所 述 ，Spring 容 器 负责 创建 应 用 程序 中 的 bean 并 通过 DI 来 协调 
这 些 对 象 之 间 的 关系 。 但 是 ， 作 为 开发 人 员 ， 你 需要 告诉 Spring 要 创建 
哪些 bean 并 且 如 何 将 其 装配 在 一 起 。 当 描述 bean 如 何 进行 装配 时 ， 
Spring 具有 非常 大 的 灵活 性 ， 它 提供 了 三 种 主要 的 装配 机 制 : 


。 在 XML 中 进行 显 式 配 置 。 
。 在 Java 中 进行 显 式 配置 。 
。 隐 式 的 bean 发 现 机 制 和 自动 装配 。 


乍 看 上 去 ， 提 供 三 种 可 选 的 配置 方案 会 使 Spring 变 得 复杂 。 每 种 配置 拉 
术 所 提供 的 功能 会 有 一 些 重 登 ， 所 以 在 特定 的 场景 中 ， 确 定 哪 种 技术 最 
为 合适 就 会 变 得 有 些 困 难 。 但 是 ， 不 必 紧 张 一 一 在 很 多 场景 下 ， 选 择 哪 
种 方案 很 大 程度 上 就 是 个 人 喜好 的 问题 ， 你 尽 可 以 选择 上 自己 最 喜欢 的 方 


式 。 























Spring 有 多 种 可 选 方案 来 配置 beaan， 这 是 非常 棒 的 ， 但 有 时 候 你 必须 要 
在 其 中 做 出 选择 。 


这 方面 ， 并 没有 唯一 的 正确 管 案 。 你 所 做 出 的 选择 必须 要 适合 你 和 你 的 
项 目 。 而 且 ， 谁 次 我 们 只 能 选择 其 中 的 一 种 方案 呢 ? Spring 的 配置 风格 
是 可 以 互相 搭配 的 ， 所 以 你 可 以 选择 使 用 XML 装 配 一 些 bean， 使 用 
Spring 基 于 Java 的 配置 (JavaConfig) 来 装配 另 一 些 bean， 而 将 剩余 的 
bean 让 Spring 去 上 自动 发 现 。 


即便 如 此 ， 我 的 建议 是 尽 可 能 地 使 用 自动 配置 的 机 制 。 显 式 配 置 越 少 越 
好 。 当 你 必须 要 显 式 配置 bean 的 时 候 〈 比 如 ， 有 些 源码 不 是 由 你 来 维护 
的 ， 而 当 你 需要 为 这 些 代 码 配 置 bean 的 时 候 ) ， 我 推荐 使 用 类 型 安全 并 
且 比 XML 更 加 强大 的 JavaConfig。 最 后 ， 只 有 当 你 想 要 使 用 便利 的 XML 
命名 空间 ， 并 且 在 JavaConfig 中 没有 同样 的 实现 时 ， 才 应 该 使 用 XML。 


在 本 章 中 ， 我 们 会 详细 介绍 这 三 种 技术 并 且 在 整 本 书 中 都 会 用 到 它们 。 
现在 ， 我 们 会 尝试 一 下 每 种 方法 ， 对 它们 是 什么 样子 的 有 一 个 直观 的 印 
象 。 作 为 Spring 配置 的 开始 ， 我 们 先 看 一 下 Spring 的 目 动 化 配置 。 











2.2 目 动 化 装配 bean 


在 本 章 稍 后 的 内 容 中 ， 和 
配 。 尽 管 你 会 发 现 这 些 显 式 装配 技术 非常 有 用 ， 但 是 在 便利 性 方面 ， 

强大 的 还 是 Spring 的 上 自动 化 配置 。 如 果 Spring 能 够 进行 目 动 化 装配 的 
话 ， 那 何苦 还 要 显 式 地 将 这 些 bean 装 配 在 一 起 呢 ? 


Spring 从 两 个 角度 来 实现 自动 化 装配 : 


。 组 件 扫 描 (component scanning) : Spring 会 自动 发 现 应 用 上 下 文中 
所 创建 的 bean。 
。 自动 装配 (autowiring) : Spring 自动 满足 bean 之 间 的 依赖 。 


组 件 扫描 和 自动 装配 组 合 在 一 起 就 能 发 挥 出 强大 的 威力 ， 它 们 能 够 将 你 
的 显 式 配置 降低 到 最 少 。 


为 了 阐述 组 件 扫描 和 装配 ， 我 们 需要 创建 几 个 bean， 它 们 代表 了 一 个 音 
响 系统 中 的 组 件 。 首 先 ， 要 创建 CompactDisc 类 ，Spring 会 发 现 它 并 将 
其 创建 为 一 个 bean。 然 后 ， 会 创建 一 个 CDPlayer 类 ， 让 Spring 发 现 它 ， 
并 将 CompactDiscbean 注 入 进来 。 


2.2.1 创建 可 被 友 现 的 bean 

在 这 个 MP3 和 流 式 媒体 音乐 的 时 代 ，CD (compact disc) 显得 有 点 典雅 
其 至 陈旧 。 它 不 像 卡 带 机 、 八 轨 磁 带 、 塑 胶 唱 片 那么 普遍 ， 随 着 以 物理 
载体 进行 音乐 交付 的 方式 越 来 越 少 ，CD 也 变 得 越 来 越 稀 少 了 。 
尽管 如 此 ，CD 为 我 们 曾 述 DI 如 何 运 行 提供 了 一 个 很 好 的 样 例 。 如 果 你 
不 将 CD 插入 (注入 ) 到 CD 播放 器 中 ， 那 么 CD 播放 器 其 实 是 没有 太 大 用 
处 的 。 所 以 ， 可 以 这 样 说 ，CD 播 放 器 依赖 于 CD 才能 完成 它 的 使 命 


为 了 在 Spring 中 前 述 这 个 例子 ， 让 我 们 首先 在 Java 中 建立 CD 的 概念 。 程 
序 清单 2.1 展 现 了 CompactDisc， 它 是 定义 CD 的 一 个 接口 : 


程序 清单 2.1 CompactDisc 接 口 在 Java 中 定义 了 CD 的 概念 


package soundsystem; 








public interface CompactDisc { 
void play() 





CompactDisc 的 具体 内 容 并 不 重要 ， 重 要 的 是 你 将 其 定义 为 一 个 接口 。 
作为 接口 ， 它 定义 了 CD 播放 融 对 一 盘 CD 所 能 进行 的 操作 。 它 将 CD 播放 
吉 的 任意 实现 与 CD 本 喘 的 耘 合 降低 到 了 最 小 的 程度 。 

我 们 还 需要 一 个 CompactDisc 的 实现 ， 实 际 上 ， 我 们 可 以 


有 CompactDisc 接 口 的 多 个 实现 。 在 本 例 中 ， 我 们 首先 会 创建 其 中 的 一 
个 实现 ， 也 就 是 程序 清单 2.2 所 示 的 SgtPeppers 类 。 








程序 清单 2.2 ”市 有 @Component 注 解 的 CompactDisc 实 现 类 SgtPeppers 


package soundsystem; 
import org.springframework.stereotype.Component; 


@Component 
public class SgtPeppers implements CompactDisc { 


private String title = "Sgt. Pepper's Lonely Hearts Club Band"; 
private String artist = "The Beatles"; 


public void play() { 
System.out.println("Playing " + title + " by " + artist); 
} 





和 CompactDisc 接 口 一 样 ，SgtPeppers 的 具体 内 容 并 不 重要 。 你 需要 
注意 的 束 是 SgtPeppers 类 上 使 用 了 @Component 注 解 。 这 个 简单 的 注解 
表明 该 类 会 作为 组 件 类 ， 并 告知 Spring 要 为 这 个 类 创建 bean。 没 有 必要 
显 式 配 置 SgtPeppersbean， 因 为 这 个 类 使 用 了 @Component 注 解 ， 所 以 
Spring 会 为 你 把 事情 处 理 受 当 。 

不 过 ， 组 件 扫 描 默 认 是 不 启用 的 。 我 们 还 需要 显 式 配置 一 下 Spring， 从 
而 命令 它 去 寻找 带 有 @Component 注 解 的 类 ， 并 为 其 创建 beaan。 程 序 清 
单 2.3 的 配置 类 展现 了 完成 这 项 任务 的 最 简洁 配置 。 


程序 清单 2.3 @ComponentScan 注 解 启用 了 组 件 扫 描 





package soundsystem; 
import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


@Configuration 

@ComponentScan 

public class CDPlayerConfig { 
} 





类 CDP1ayerConfig 通 过 Java 代 码 定 义 了 Spring 的 装配 规则 。 在 2.3 贡 

中 ， 我 们 还 会 更 为 详细 地 介绍 基于 Java 的 Spring 配置 。 不 过 ， 现 在 我 们 
只 需 观 察 一 下 CDP1ayerConfig 类 并 没有 显 式 地 声明 任何 bean， 只 不 过 
了 @Ccomponentscan 注 解 ， 这 个 注解 能 够 在 Spring 中 局 用 组 件 扫 


如 果 没 有 其 他 配置 的 话 ，@ComponentScan 默 认 会 扫描 与 配置 类 相同 的 
包 。 因 为 CDPlayerConfig 类 位 于 soundsystem 包 中 ， 因 此 Spring 将 会 
扫描 这 个 包 以 及 这 个 包 下 的 所 有 子 包 ， 碍 找 带 有 Q@Component 注 解 的 
类 。 这 样 的 话 ， 就 能 发 现 CompactDisc， 并 且 会 在 Spring 中 自动 为 其 创 
建 一 个 bean。 


如 果 你 更 倾 问 于 使 用 XML 来 启用 组 件 扫 摘 的 话 ， 那 么 可 以 使 用 Spring 
context 命 名 空间 的 <context :component-scan> 元 素 。 程 序 清单 2.4 
展示 了 启用 组 件 扫描 的 最 简洁 XML 配置 。 


程序 清单 2.4 通过 XML 启用 组 件 扫描 








<?xml version="1.60" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/26001/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 


http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd"> 


<context:component-scan base-package="soundsystem" /> 


</beans> 





尽管 我 们 可 以 通过 XML 的 方案 来 月 用 组 件 扫描 ， 但 是 在 后 面 的 讨论 


中 ， 我 更 多 的 还 是 会 使 用 基于 Java 的 配置 。 如 果 你 更 喜欢 XML 的 
话 ，<context:component-scan> 元 素 会 有 与 @ComponentScan 注 解 相 
对 应 的 属性 和 子 元 素 。 


可 能 有 点 让 人 难以 置信 ， 我 们 只 创建 了 两 个 类 ， 就 能 对 功能 进行 一 番 沧 
斌 了。 为 了 测试 组 件 扫描 的 功能 ， 我 们 创建 一 个 简单 的 JUnit 测 试 ， 它 会 
创建 Spring 上 下 文 ， 并 判断 CompactDisc 是 不 是 真 的 创建 出 来 了 。 程 序 
清单 2.5 中 的 CDPlayerTest 就 是 用 来 完成 这 项 任务 的 。 


程序 清单 2.5 测试 组 件 扫 摘 能 够 发 现 CompactDisc 





package soundsystem; 


import static org.junit.Assert.*; 


import org.junit.Test; 

import org.junit.runner.RunWith; 

import org.springframework.beans.factory.annotation.Autowired; 

import org.springframework.test.context.ContextConfiguration; 

import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 


@RunWith(SpringJUnit4ClassRunner .class) 
@ContextConfiguration(classes=CDPlayerConfig.class) 
public class CDPlayerTest { 


@Autowired 
private CompactDisc cd; 


@Test 

public void cdShouldNotBeNull() { 
assertNotNull(cd); 

} 





CDPlayerTest 使 用 了 Spring 的 SpringJUnit4ClassRunner， 以 便 在 测 
试 开 始 的 时 候 上 自动 创建 Spring 的 应 用 上 下 文 。 注 解 
@ContextConfiguration 会 告诉 它 需 要 在 CDPlayerConfig 中 加 载 配 
置 。 因 为 CDPlayerConfig 类 中 包含 了 @ComponentSscan， 因 此 最 终 的 
应 用 上 下 文中 应 该 包含 CompactDiscbean。 


为 了 证 明 这 一 点 ， 在 测试 代码 中 有 一 个 CompactDisc 类 型 的 属性 ， 并 且 


这 个 属性 带 有 @Autowired 注 解 ， 以 便于 将 CompactDiscbean 注 入 到 测 
试 代码 之 中 ( 稍 后 ， 我 会 讨论 @Autowired) 。 最 后 ， 会 有 一 个 简单 的 
测试 方法 断言 cd 属性 不 为 null。 如 果 它 不 为 nu 的话， 就 意味 着 Spring 能 
够 发 现 CompactDisc 类 ， 自 动 在 Spring 上 下 文中 将 其 创建 为 bean 并 将 其 
注入 到 测试 代码 之 中 。 


这 个 代码 应 该 能 够 通过 测试 ， 并 以 测试 成 功 的 颜色 显示 在 你 的 测试 运 
行 器 中 ， 或 许 会 希望 出 现 绿色 ) 。 你 第 一 个 简单 的 组 件 扫描 练习 就 成 功 
了 ! 尽管 我 们 只 用 它 创 建 了 一 个 bean， 但 同样 是 这 么 少 的 配置 能 够 用 来 
发 现 和 创建 任意 数量 的 bean。 在 soundsystem 包 及 其 子 包 中 ， 所 有 带 
有 @Component 注 解 的 类 都 会 创建 为 bean。 只 添加 一 行 @ComponentScan 
注解 就 能 自动 创建 无 数 个 bean， 这 种 权衡 还 是 很 划算 的 。 


现在 ， 我 们 会 更 加 深入 地 探讨 @ComponentScan 和 @Component， 看 一 下 
使 用 组 件 扫描 还 能 做 些 什么 。 


2.2.2 ”为 组 件 扫 摘 的 bean 命 名 


Spring 应 用 上 下 文中 所 有 的 bean 都 会 给 定 一 个 ID。 在 前 面 的 例子 中 ， 尽 
管 我 们 没有 明确 地 为 SgtPeppersbean 设 置 ID， 但 Spring 会 根据 类 名 为 其 
指定 一 个 ID。 有 具体 来 讲 ， 这 个 bean 所 给 定 的 ID 为 sgtPeppers， 也 就 是 
将 类 名 的 第 一 个 字母 变 为 小 写 。 


如 果 想 为 这 个 bean 设 置 不 同 的 ID， 你 所 要 做 的 就 是 将 期 望 的 ID 作为 值 传 
递 给 QComponent 注 解 。 比 如 说 ， 如 果 想 将 这 个 bean 标 识 

为 1onelyHeartsClub， 那 么 你 需要 将 SgtPeppers 类 的 @Component 注 
解 配置 为 如 下 所 示 : 





@Component("lonelyHeartsClub") 
public class SgtPeppers implements CompactDisc { 


} 








还 有 另外 一 种 为 bean 命 名 的 方式 ， 这 种 方式 不 使 用 QComponent 注 解 ， 
而 是 使 用 Java 依 赖 注入 规范 (Java Dependency Injection ) 中 所 提供 的 
@Named 注 解 来 为 bean 设 置 ID: 


package soundsystem; 


import javax.inject.Named; 


@Named("lonelyHeartsClub") 
public class SgtPeppers implements CompactDisc { 


ee 





Spring 支 持 将 @Named 作 为 @Component 注 解 的 替代 方案 。 两 者 之 间 有 一 
些 细 微 的 差异 ， 但 是 在 大 多 数 场景 中 ， 它 们 是 可 以 互相 替换 的 。 


话 虽 如 此 ， 我 更 加 强烈 地 喜欢 @Component 注 解 ， 而 对 于 @Named.…. 怎 么 
说 呢 ， 我 感觉 它 的 名 字 起 得 很 不 好 。 它 并 没有 像 @Component 那 样 清楚 
地 表明 它 是 做 什么 的 。 因 此 在 本 书 及 其 示例 代码 中 ， 我 不 会 再 使 用 
Named。 


2.2.3 ”设置 组 件 扫描 的 基础 包 


到 现在 为 止 ， 我 们 没有 为 @ComponentScan 设 置 任何 属性 。 这 意味 着 ， 
按照 默认 规则 ， 它 会 以 配置 类 所 在 的 包 作为 基础 包 (base package) 来 
扫 拉 组件 。 但 是 ， 如 果 你 想 扫 摘 不 同 的 包 ， 那 该 怎么 办 呢 ? 或 者 ， 如 果 
你 想 扫 描 多 个 基础 包 ， 那 又 该 怎么 办 呢 ? 


有 一 个 原因 会 促使 我 们 明确 地 设置 基础 包 ， 那 就 是 我 们 想 要 将 配置 类 放 
在 单独 的 包 中 ， 使 其 与 其 他 的 应 用 代码 区 分 开 来 。 如 果 是 这 样 的 话 ， 那 
默认 的 基础 包 就 不 能 满足 要 求 了 。 


要 满足 这 样 的 需求 其 实 也 完全 没有 问题 ! 为 了 指定 不 同 的 基础 包 ， 你 所 
需要 做 的 就 是 在 @ComponentScan 的 value 属 性 中 指明 包 的 名 称 : 














@Configuration 
@ComponentScan("soundsystem") 
public class CDPlayerConfig {} 


如 果 你 想 更 加 清晰 地 表明 你 所 设置 的 是 基础 包 ， 那 么 你 可 以 通过 
basePackages 属 性 进行 配置 : 


@Configuration 
@ComponentScan(basePackages="soundsystem") 
public class CDPlayerConfig {} 


可 能 你 已 经 注意 到 了 basepPackages 属 性 使 用 的 是 复数 形式 。 如 果 你 揣 
测 这 是 不 是 意味 着 可 以 设置 多 个 基础 包 ， 那 么 恭喜 你 猜 对 了 。 如 果 想 要 
这 么 做 的 话 ， 只 需要 将 basePackages 属 性 设置 为 要 扫描 包 的 一 个 数组 
即 可 : 











@Configuration 


@ComponentScan(basePackages={"soundsystem", "video"}) 
public class CDPlayerConfig {} 





在 上 面 的 例子 中 ， 所 设置 的 基础 包 是 以 String 类 型 表示 的 。 我 认为 这 
是 可 以 的 ， 但 这 种 方法 是 类 型 不 安全 (not type-safe〉 的 。 如 果 你 重 构 代 
码 的 话 ， 那 么 所 指定 的 基础 包 可 能 就 会 出 现 错误 了 。 


除了 将 包 设 置 为 简单 的 String 类 型 之 外 ，@Ccomponentscan 还 提供 了 另外 
一 种 方法 ， 那 就 是 将 其 指定 为 包 中 所 包含 的 类 或 接口 : 








@Configuration 
@ComponentScan(basePackageClasses={CDPlayer.class, DVDPlayer.class}) 
public class CDPlayerConfig {} 


可 以 看 到 ，basepPackages 属 性 被 蔡 换 成 了 basePackageClasses。 同 
时 ， 我 们 不 是 再 使 用 String 类 型 的 名 称 来 指定 包 ， 

为 basePackageClasses 属 性 所 设置 的 数组 中 包含 了 类 。 这 些 类 所 在 的 
包 将 会 作为 组 件 扫描 的 基础 包 。 


尽管 在 样 例 中 ， 我 为 basePackageClasses 设 置 的 是 组 件 类 ， 但 是 你 可 
以 考虑 在 包 中 创建 一 个 用 来 进行 扫 拉 的 空 标记 接口 (marker 

interface) 。 通 过 标记 接口 的 方式 ， 你 依然 能 够 保持 对 重 构 友 好 的 接口 
引用 ， 但 是 可 以 避免 引用 任何 实际 的 应 用 程序 代码 〈 在 稍 后 重 构 中 ， 这 
些 应 用 代码 有 可 能 会 从 想 要 扫描 的 包 中 移 除 掉 ) 。 


在 你 的 应 用 程序 中 ， 如 果 所 有 的 对 象 都 是 独立 的 ， 役 此 之 间 没 有 任何 依 
赖 ， 束 像 SgtPeppersbean 这 样 ， 那 么 你 所 需要 的 可 能 就 是 组 件 扫 描 而 
己 。 但 是 ， 很 多 对 象 会 依赖 其 他 的 对 象 才能 完成 任务 。 这 样 的 话 ， 我 们 
就 需要 有 一 种 方法 能 够 将 组 件 扫描 得 到 的 bean 和 它们 的 依赖 净 配 在 一 
起 。 要 完成 这 项 任务 ， 我 们 需要 了 解 一 下 Spring 自 动 化 配置 的 为 外 一 方 
面 内 容 ， 那 就 是 目 动 装配 。 














2.2.4 通过 为 bean 添 加 注解 实现 自动 装配 


简单 来 说 ， 自 动 装配 就 是 让 Spring 自动 满足 bean 依 赖 的 一 种 方法 ， 在 满 
足 依赖 的 过 程 中 ， 会 在 Spring 应 用 上 下 文中 寻找 匹配 某 个 bean 需 求 的 其 
sn 
注解 。 

比方 说 ， 考虑 程序 清单 2. 6 中 的 CDPlayer 类 。 它 的 构造 器 上 添加 了 
@Autowired 注 解 ， 这 表明 当 Spring 创 建 CDPlayerbean 的 时 候 ， 会 通过 
这 个 构造 器 来 进行 实例 化 并 且 会 传 入 一 个 可 设置 给 CompactDisc 类 型 的 


bean 。 











程序 清单 2.6 ”通过 自动 装配 ， 将 一 个 CompactDisc 注 入 到 CDPlayer 之 
中 


package soundsystem; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Component; 


@Component 
public class CDPlayer implements MediaPlayer { 
private CompactDisc cd; 


@Autowired 

public CDP1ayer(CompactDisc cd) { 
this.cd = cd; 

} 


public void play() { 
cd.play(); 





Q@Autowired 注 解 不 仅 能 够 用 在 构造 器 上 ， 还 能 用 在 属性 的 Setter 方 法 
上 。 比 如 说 ， 如 果 CDP1ayer 有 一 个 setCompactDisc() 方 法 ， 那 么 可 以 
采用 如 下 的 注解 形式 进行 自动 装配 : 


@Autowired 
public void setCompactDisc(CompactDisc cd) { 


this.cd = cd; 
} 





在 Spring 初始 化 bean 之 后 ， 它 会 尽 可 能 得 去 满足 bean 的 依赖 ， 在 本 例 
中 ， 依 赖 是 通过 带 有 Q@Autowired 注 解 的 方法 进行 声明 的 ， 也 就 
是 setCompactDisc()。 


实际 上 ，Setter 方 法 并 没有 什么 特殊 之 处 。@Autowired 注 解 可 以 用 在 类 
的 任何 方法 上 。 假 设 CDP1ayer 类 有 一 个 InsertDisc() 方 法 ， 那 

么 @Autowired 能 够 像 在 setCompactDisc() 上 那样 ， 发 挥 完全 相同 的 
作用 : 


@Autowired 
public void insertDisc(CompactDisc cd) { 


this.cd = cd; 
} 





不 管 是 构造 嚣 、Setter 方 法 还 是 其 他 的 方法 ，Spring 都 会 尝试 满足 方法 参 
数 上 所 声明 的 依赖 。 假 如 有 且 只 有 一 个 bean 匹 配 依赖 需求 的 话 ， 那 么 这 
个 bean 将 会 被 装配 进来 。 


如 果 没 有 匹配 的 bean， 那 么 在 应 用 上 下 文 创建 的 时 候 ，Spring 会 抛 出 一 
个 异常 。 为 了 避免 异常 的 出 现 ， 你 可 以 将 @Autowired 的 required 属 性 
设置 为 false: 


@Autowired(required=false) 
public CDPlayer(CompactDisc cd) { 


this.cd = cd; 
} 


将 required 属 性 设置 为 false 时 ，Spring 会 尝试 执行 自动 装配 ， 但 是 如 
果 没 有 匹配 的 bean 的 话 ，Spring 将 会 让 这 个 bean 处 于 未 装配 的 状态 。 但 
是 ， 把 required 属 性 设置 为 false 时 ， 你 需要 谨慎 对 待 。 如 果 在 你 的 代 
人 码 中 没有 进行 null 检 查 的 话 ， 这 个 处 于 未 疙 配 状态 的 属性 有 可 能 会 出 现 


NullPointerException。 


如 果 有 多 个 bean 都 能 满足 依赖 关系 的 话 ，Spring 将 会 抛 出 一 个 异常 ， 表 
明 没 有 明确 指定 要 选择 哪个 bean 进 行 目 动 装配 。 在 第 3 章 中 ， 我 们 会 进 
一 步 讨 论 上 自动 装配 中 的 歧义 性 。 


Q@Autowired 是 Spring 特有 的 注解 。 如 果 你 不 愿意 在 代码 中 到 处 使 用 

















Spring 的 特定 注解 来 完成 自动 装配 任务 的 话 ， 那 么 你 可 以 考虑 将 其 蔡 换 
为 QInJject: 
package soundsystem; 


import javax.inject.Inject; 
import javax.inject.Named; 


@Named 
public class CDPlayer { 


@Inject 

public CDP1ayer(CompactDisc cd) { 
this.cd = cd; 

} 





@Inject 注 解 来 源 于 Java 依 赖 注入 规范 ， 该 规范 同时 还 为 我 们 定义 了 
QNamed 注 解 。 在 自动 装配 中 ，Spring 同 时 文 持 6Inject 和 
@Autowired。 尺 管 @Inject 和 @Autowired 之 间 有 着 一 些 细微 的 差别 ， 
但 是 在 大 多 数 场 景 下 ， 它 们 都 是 可 以 互相 蔡 换 的 。 


在 @Inject 和 @Autowired 中 ， 我 没有 特别 强烈 的 偏 回 性 。 实 际 上 ， 在 
有 的 项 目 中 ， 我 会 发 现 我 同时 使 用 了 这 两 个 注解 。 不 过 在 本 书 的 样 例 
我 会 一直 使 用 @Autowired， 而 你 可 以 根据 自己 的 情况 ， 选 择 其 中 
可 作 忆 人 


2.2.5 “验证 自动 装配 


现在 ， 我 们 已 经 在 CDP1ayer 的 构造 器 中 添加 了 @Autowired 注 解 ， 
Spring 将 把 一 个 可 分 配给 CompactDisc 类 型 的 bean 目 动 注 入 进来 。 为 了 
验证 这 一 点 ， 让 我 们 修改 一 下 CDPlayerTest， 使 其 能 够 借助 CDPlayer 
bean 播 放 CD: 

















package soundsystem; 

import static org.junit.Assert.*; 

import org.junit.Rule; 

import org.junit.Test; 

import org.junit.contrib.java.lang.system.StandardOutputStreamLog; 


import org.junit.runner.RunWith; 

import org.springframework.beans .factory.annotation.Autowired ; 

import org.springframework.test.context.ContextConfiguration; 

import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 


Q@RunwWith(SpringJUnit4CL1assRunner.class) 
@ContextConfiguration(classes=CDPlayerConfig.class) 
public class CDPlayerTest { 


@Rule 
public final StandardOutputStreamLog log = 
new StandardOutputStreamLog(); 


@Autowired 
private MediaPlayer player; 


@Autowired 
private CompactDisc cd; 


@Test 

public void cdShouldNotBeNull() { 
assertNotNull(cd); 

} 


@Test 
public void play() { 
player.play(); 
assertEquals( 
"Playing Sgt. Pepper's Lonely Hearts Club Band" + 
”by The Beatles\n", 


log.getLog()); 





现在 ， 除 了 注入 CompactDisc， 我 们 还 将 CDPlayerbean 注 入 到 测试 代 





人 码 的 player 成 员 变 量 之 中 〔( 它 是 更 为 通用 的 MediaPlayer 类 型 ) 。 
0 我 们 可 以 调用 CDPlayer 的 play0 方 法 ， 并 断言 它 
的 行为 与 你 的 预期 一 致 。 


在 测试 代码 中 使 用 System.out .println() 是 稍微 有 点 环 手 的 事情 。 因 
该 样 例 中 使 用 了 standardoutputSstreamLog， 这 是 来 源 于 System 

Rules 库 〈http:/stefanbirkner.github.io/system-rules/index.html) 的 一 个 

JUnit 规 则 ， 该 规则 能 够 基于 控制 全 的 输出 编写 断言 。 在 这 里 ， 我 们 断 


言 SgtPeppers.play() 方 法 的 输出 被 发 送 到 了 控制 台 上 。 


现在 ， 你 已 经 了 解 了 组 件 扫描 和 上 自动 装配 的 基础 知识 ， 在 第 3 章 中 ， 当 
我 们 介绍 如 何 处 理 目 动 闭 配 的 歧义 性 时 ， 还 会 继续 研究 组 件 扫描 。 


但 是 现在 ， 我 们 先 将 组 件 扫描 和 目 动 装配 放 在 一 边 ， 看 一 下 在 Spring 中 
如 何 显 式 地 装配 bean， 首 先 从 通过 Java 代 码 编写 配置 开始 。 





2.3 ”通过 Java 代 人 码 装 配 bean 


尽管 在 很 多 场景 下 通过 组 件 扫描 和 自动 装配 实现 Spring 的 自动 化 配置 是 
更 为 推荐 的 方式 ， 但 有 时 候 自动 化 配置 的 方案 行 不 通 ， 因 此 需要 明确 配 
置 Spring。 比 如 说 ， 你 想 要 将 第 三 方 库 中 的 组 件 装配 到 你 的 应 用 中 ， 在 
这 种 情况 下 ， 是 没有 办 法 在 它 的 类 上 添加 @Component 和 @Autowired 注 
解 的 ， 因 此 就 不 能 使 用 自动 化 装配 的 方案 了 。 


在 这 种 情况 下 ， 你 必须 要 采用 显 式 装配 的 方式 。 在 进行 显 式 配置 的 时 
候 ， 有 两 种 可 选 方案 : Java 和 XML 。 在 这 节 中 ， 我 们 将 会 学 习 如 何 使 用 
Java 配 置 ， 接 下 来 的 一 节 中 将 会 继续 学 习 Spring 的 XML 配置 。 


就 像 我 之 前 所 说 的 ， 在 进行 显 式 配置 时 ，JavaConfig 是 更 好 的 方案 ， 
为 它 更 为 强大 、 类 型 安全 并 且 对 重 构 友 好 。 因 为 它 就 是 Java 人 代码， 就 像 
应 用 程序 中 的 其 他 Java 代 码 一 样 。 


同时 ，JavaConfig 与 其 他 的 Java 代 人 码 又 有 所 区 别 ， 在 概念 上 ， 它 与 应 用 
程序 中 的 业务 逻辑 和 领域 代码 是 不 同 的 。 尽 管 它 与 其 他 的 组 件 一 样 都 使 
用 相同 的 语言 进行 表述 ， 但 JavaConfig 是 配置 代码 。 这 意味 着 它 不 应 该 
包含 任何 业务 逻辑 ，JavaConfig 也 不 应 该 侵入 到 业务 逻辑 代码 之 中 。 尽 
管 不 是 必须 的 ， 但 通常 会 将 JavaConfig 放 到 单独 的 包 中 ， 使 它 与 其 他 的 
应 用 程序 逻辑 分 离开 来 ， 这 样 对 于 它 的 意图 束 不 会 产生 困惑 了 。 


接 下 来 ， 让 我 们 看 一 下 如 何 通 过 JavaConfig 显 式 配 置 Spring。 
2.3.1 创建 配置 类 


在 本 章 前 面 的 程序 清单 2.3 中 ， 我 们 第 一 次 见识 到 JavaConfig。 让 我 们 重 
温 一 下 那个 样 例 中 的 CDPlayerConfig: 












































package soundsystem; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
public class CDPlayerConfig { 
} 





创建 JavaConfig 类 的 关键 在 于 为 其 添加 @Configuration 注 
解 ，QConfiguration 注 解 表 明 这 个 类 是 一 个 配置 类 ， 该 类 应 该 包含 在 
Spring 应 用 上 下 文中 如 何 创建 bean 的 细 市 。 


到 此 为 止 ， 我 们 都 是 依赖 组 件 扫描 来 发 现 Spring 应 该 创建 的 bean。 尺 管 
我 们 可 以 同时 使 用 组 件 扫描 和 显 式 配置 ， 但 是 在 本 节 中 ， 我 们 更 加 关注 
于 显 式 配置 ， 因 此 我 将 CDPlayerConfig 的 @ComponentScan 注 解 移 除 
把 了 。 


移 除了 @ComponentScan 注 解 ， 此 时 的 CDPlayerConfig 类 就 没有 任何 
作用 了 。 如 果 你 现在 运行 CDPlayerTest 的 话 ， 测 试 会 失败 ， 并 且 会 出 
现 BeanCreation- Exception 异常。 测试 期 望 被 注入 CDP1ayer 和 

但 是 这 些 bean 根 本 就 没有 创建 ， 因 为 组 件 扫描 不 会 发 现 
Cl]s 


为 了 再 次 让 测试 通过 ， 你 可 以 将 @ComponentScan 注 解 添加 回去 ， 但 是 
我 们 这 一 节 关 注 显 式 配 置 ， 因 此 让 我 们 看 一 下 如 何 使 用 JavaConfig 装 
配 CDPlayer 和 CompactDisc。 














2.3.2 ”声明 简单 的 bean 


要 在 JavaConfig 中 声明 bean， 我 们 需要 编写 一 个 方法 ， 这 个 方法 会 创建 
所 需 类 型 的 实例 ， 然 后 给 这 个 方法 添加 @Bean 注 解 。 比 方 说 ， 下 面 的 代 
码 声 明了 CompactDisc bean: 


@Bean 
public CompactDisc sgtPeppers() { 


return new SgtPeppers(); 


} 





@Bean 注 解 会 告诉 Spring 这 个 方法 将 会 返回 一 个 对 象 ， 该 对 象 要 注册 为 
Spring 应 用 上 下 文中 的 pean。 方 法 体 中 包含 了 最 终 产 生 bean 实 例 的 多 
辑 。 


默认 情况 下 ，bean 的 ID 与 带 有 @Bean 注 解 的 方法 名 是 一 样 的 。 在 本 例 
中 ，bean 的 名 字 将 会 是 sgtPeppers。 如 果 你 想 为 其 设置 成 一 个 不 同 的 
名 字 的 话 ， 那 么 可 以 重 命 名 该 方法 ， 也 可 以 通过 name 属 性 指定 一 个 不 同 
的 名 字 : 


@Bean(name="lonelyHeartsClubBand") 
public CompactDisc sgtPeppers() { 


return new SgtPeppers(); 


} 


不 管 你 采用 什么 方法 来 为 bean 命 名 ，bean 声 明 都 是 非常 简单 的 。 方 法 体 
返回 了 一 个 新 的 SgtPeppers 实 例 。 这 里 是 使 用 Java 来 进行 描述 的 ， 
此 我 们 可 以 发 挥 Java 提 供 的 所 有 功能 ， 只 要 最 终生 成 一 个 CompactDisc 
实例 即 可 。 


请 稍微 发 挥 一 下 你 的 想象 力 ， 我 们 可 能 希望 做 一 点 稍微 疯狂 的 事情 ， 比 
如 说 ， 在 一 组 CD 中 随机 选择 一 个 CompactDisc 来 播放 : 











@Bean 
public CompactDisc randomBeatlesCD() { 
int choice = (int) Math.floor(Math.random() * 4); 
if (choice == 60) { 
return new SgtPeppers(); 
else if (choice == 1) { 


return new WhiteAlbum(); 
else if (choice == 2) { 
return new HardDaysNight(); 
else { 

return new Revolver(); 





现在 ， 你 可 以 自己 想象 一 下 ， 借 助 @Bean 注 解 方 法 的 形式 ， 我 们 该 如 何 
发 挥 出 Java 的 全 部 威力 来 产生 bean。 当 你 想 完 之 后 ， 我 们 要 回 过 头 来 看 
一 下 在 JavaConfig 中 ， 如 何 将 CompactDisc 注 入 到 CDPlayer 之 中 。 


2.3.3 ”借助 JavaConfig 实 现 注 入 

我 们 前 面 所 声明 的 CompactDisc bean 是 非常 简单 的 ， 它 自身 没有 其 他 的 
依赖 。 但 现在 ， 我 们 需要 声明 CDP1ayerbean， 它 依赖 于 
CompactDisc。 在 JavaConfig 中 ， 要 如 何 将 它们 装配 在 一 起 呢 ? 


在 JavaConfig 中 装配 bean 的 最 简单 方式 就 是 引用 创建 bean 的 方法 。 例 
如 ， 下 面 就 是 一 种 声明 CDPlayer 的 可 行 方案 : 


@Bean 


public CDPlayer cdPlayer() { 
return new CDPlayer(sgtPeppers()); 
} 


cdPlayer() 方 法 像 sgtPeppers() 方 法 一 样 ， 同 样 使 用 了 @Bean 注 解 ， 
这 表明 这 个 方法 会 创建 一 个 bean 实 例 并 将 其 注册 到 Spring 应 用 上 下 文 
中 。 所 创建 的 bean ID 为 cdPlayer， 与 方法 的 名 字 相 同 。 


cdPlayer() 的 方法 体 与 sgtPeppers() 稍 微 有 些 区 别 。 在 这 里 并 没有 使 
用 默认 的 构造 器 构建 实例 ， 而 是 调用 了 需要 传 入 CompactDisc 对 象 的 构 
造 器 来 创建 CDPlayer 实 例 。 


看 起 来 ，CompactDisc 是 通过 调用 sgtPeppers() 得 到 的 ， 但 情况 并 非 
完全 如 此 。 因 为 sgtPeppers() 方 法 上 添加 了 @Bean 注 解 ，Spring 将 会 拦 
截 所 有 对 它 的 调用 ， 并 确保 直接 返回 该 方法 所 创建 的 bean， 而 不 是 每 次 
都 对 其 进行 实际 的 调用 。 


比如 说 ， 假设 你 引入 了 一 个 其 他 的 CDPlayerbean， 它 和 之 前 的 那个 bean 


@Bean 
public CDPlayer cdPlayer() { 

return new CDPlayer(sgtPeppers()); 
} 


@Bean 

public CDPlayer anotherCDP1ayer() { 
return new CDPlayer(sgtPeppers()); 

} 





假如 对 sgtPeppers() 的 调用 就 像 其 他 的 Java 方 法 调用 一 样 的 话 ， 那 么 

每 个 CDP1ayer 实 例 都 会 有 一 个 目 己 特有 的 SgtPeppers 实 例 。 如 果 我 们 
讨论 的 是 实际 的 CD 播放 器 和 CD 光盘 的 话 ， 这 么 做 是 有 意义 的 。 如 果 你 
es 在 物理 上 并 没有 办 法 将 同一 张 CD 光 盘 放 到 两 个 CD 播 
丰硕 中 。 


但 是 ， 在 软件 领域 中 ， 我 们 完全 可 以 将 同一 个 SgtPeppers 实 例 注 入 到 
任意 数量 的 其 他 bean 之 中 。 默 认 情 况 下 ，Spring 中 的 bean 都 是 单 例 的 ， 
我 们 并 没有 必要 为 第 二 个 CDPlayer bean 创 建 完全 相同 的 SgtPeppers 实 
例 。 所 以 ，Spring 会 拦截 对 sgtPeppers() 的 调用 并 确保 返回 的 是 Spring 





所 创建 的 bean， 也 就 是 Spring 本 映 在 调用 sgtPeppers() 时 所 创建 的 
CompactDiscbean。 因 此 ， 两 个 CDP1ayer bean 会 得 到 相同 的 
SgtPeppers 实 例 。 


可 以 看 到 ， 通 过 调用 方法 来 引用 bean 的 方式 有 点 令 人 困惑 。 其 实 还 有 一 
种 理解 起 来 更 为 简单 的 方式 : 


@Bean 
public CDPlayer cdP1layer(CompactDisc compactDisc) { 


return new CDPlayer(compactDisc); 


} 





在 这 里 ，cdPlayer() 方 法 请 求 一 个 CompactDisc 作 为 参数 。 当 Spring 调 
用 cdPlayer() 创 建 CDP1ayerbean 的 时 候 ， 它 会 自动 装配 一 

个 CompactDisc 到 配置 方法 之 中 。 然 后 ， 方 法 体 就 可 以 按照 合适 的 方式 
来 使 用 它 。 借 助 这 种 技术 ，cdPlayer() 方 法 也 能 够 将 CompactDisc 注 
Ee 而 且 不 用 明确 引用 CompactDisc 的 @Bean 方 


通过 这 种 方式 引用 其 他 的 bean 通 常 是 最 佳 的 选择 ， 因 为 它 不 会 要 求 

将 CompactDisc 声 明 到 同一 个 配置 类 之 中 。 在 这 里 甚至 没有 要 

求 CompactDisc 必 须要 在 JavaConfig 中 声明 ， 实 际 上 它 可 以 通过 组 件 扫 
描 功 能 自动 发 现 或 者 通过 XML 来 进行 配置 。 你 可 以 将 配置 分 散 到 多 个 
配置 类 、XML 文 件 以 及 自动 扫描 和 装配 bean 之 中 ， 只 要 功能 完整 健全 即 
可 。 不 管 CompactDisc 是 采用 什么 方式 创建 出 来 的 ，Spring 都 会 将 其 传 
入 到 配置 方法 中 ， 并 用 来 创建 CDPlayer bean。 


另外 ， 需 要 提醒 的 是 ， 我 们 在 这 里 使 用 CDPlayer 的 构造 器 实现 了 DI 功 
能 ， 但 是 我 们 完全 可 以 采用 其 他 风格 的 DI 配置 。 比 如 说 ， 如 果 你 想 通 过 
Setter 方 法 注入 CompactDisc 的 话 ， 那 么 代码 看 起 来 应 该 是 这 样 的 : 











@Bean 
public CDPlayer cdP1layer(CompactDisc compactDisc) { 
CDPlayer cdPlayer = new CDPlayer(compactDisc); 


cdPlayer.setCompactDisc(compactDisc); 
return cdPlayer; 


} 





再 次 强调 一 迄 ， 带 有 @Bean 注 解 的 方法 可 以 采用 任何 必要 的 Java 功 能 3 


产生 bean 实 例 。 构 造 器 和 Setter 方 法 只 是 6Bean 方 法 的 两 个 简单 样 例 。 这 
里 所 存在 的 可 能 性 仅仅 受到 Java 语 言 的 限制 。 


2.4 通过 XML 装配 bean 


到 此 为 止 ， 我 们 已 经 看 到 了 如 何 让 Spring 自动 发 现 和 装配 bean， 还 看 到 
了 如 何 进行 手动 干预 ， 即 通过 JavaConfig 显 式 地 装配 bean。 但 是 ， 在 装 
配 bean 的 时 候 ， 还 有 一 种 可 选 方案 ， 尽 管 这 种 方案 可 能 不 太 合 乎 大 家 的 
心意 ， 但 是 它 在 Spring 中 已 经 有 很 长 的 历史 了 。 


在 Spring 刚刚 出 现 的 时 候 ，XML 是 描述 配置 的 主要 方式 。 在 Spring 的 名 
在 一 定 程 度 上 ，Spring 成 为 了 XML 
配置 的 同义词 。 


尽管 Spring 长 期 以 来 确实 与 XML 有 着 关联 ， 但 现在 需要 明确 的 是 ，XML 
不 再 是 配置 Spring 的 唯一 可 选 方 案 。Spring 现 在 有 了 强大 的 自动 化 配置 
和 基于 Java 的 配置 ，XML 不 应 该 再 是 你 的 第 一 选择 了 。 


不 过 ， 鉴 于 已 经 存在 那么 多 基于 XML 的 Spring 配置 ， 所 以 理解 如 何在 
Spring 中 使 用 XML 还 是 很 重要 的 。 但 是 ， 我 希望 本 节 的 内 容 只 是 用 来 帮 
助 你 维护 已 有 的 XML 配置 ， 在 完成 新 的 Spring 工作 时 ， 硕 望 你 会 使 用 自 
动 化 配置 和 JavaConfig 。 








2.4.1 创建 XML 配置 规范 


在 使 用 XML 为 Spring 装配 bean 之 前 ， 你 需要 创建 一 个 新 的 配置 规范 。 在 
使 用 JavaConfig 的 时 候 ， 这 意味 着 要 创建 一 个 珊 有 @Configuration 注 
解 的 类 ， 而 在 XML 配置 中 ， 这 意味 着 要 创建 一 个 XML 文件 ， 并 且 要 以 
<beans> 元 素 为 根 。 


最 为 简单 的 Spring XML 配置 如 下 所 示 : 








<?xml version="1.6” encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context"> 


<!-- configuration details go here --> 


</beans> 


很 容易 就 能 看 出 来 ， 这 个 基本 的 XML 配置 已 经 比 同 等 功能 的 JavaConfig 
类 复杂 得 多 了 。 作 为 起 步 ， 在 JavaConfig 中 所 需要 的 只 

是 @Configuration， 但 在 使 用 XML 时 ， 需 要 在 配置 文件 的 顶部 声明 多 
个 XML 模式 〈XSD) 文件 ， 这 些 文件 定义 了 配置 Spring 的 XML 元 素 。 








借助 Spring Tool Suite 创 建 XML 配置 文 件 创 建 和 管理 Spring XML 配 
置 文件 的 一 种 简便 方式 是 使 用 Spring Tool 

Suite (https:/spring.io/tools/sts) 。 在 Spring Tool Suite 的 荣 单 中 ， 选 
择 File>New>Spring Bean Configuration File， 能 够 创建 Spring XML 
配置 文件 ， 并 且 可 以 选择 可 用 的 配置 命名 空间 。 


用 来 装配 bean 的 最 基本 的 XML 元 素 包 售 在 spring-beans 模 式 之 中 ， 在 
上 上面 这 个 XML 文件 中 ， 它 被 定义 为 根 命名 空间 。xbeans> 是 该 模式 中 的 
一 个 元 素 ， 它 是 所 有 Spring 配置 文件 的 根 元 素 。 


在 XML 中 配置 Spring 时 ， 还 有 一 些 其 他 的 模式 。 尽 管 在 本 书 中 ， 我 更 加 
关注 目 动 化 以 及 基于 Java 的 配置 ， 但 是 在 本 书 讲解 的 过 程 中 ， 当 出 现 其 
他 模式 的 时 候 ， 我 至 少 会 提醒 你 。 


就 这 样 ， 我 们 已 经 有 了 一 个 合法 的 Spring XML 配置 。 不 过 ， 它 也 是 一 个 
没有 任何 用 处 的 配置 ， 因 为 它 (还 ) 没有 声明 任何 bean。 为 了 给 予 它 生 
命 力 ， 让 我 们 重新 创建 一 下 CD 样 例 ， 只 不 过 我 们 这 次 使 用 XML 配 置 ， 
而 不 是 使 用 JavaConfig 和 自动 化 装配 。 





2.4.2 ”声明 一 个 简单 的 <bean> 
要 在 基于 XML 的 Spring 配 置 中 声明 一 个 bean， 我 们 要 使 用 spring- 


beans 模 式 中 的 另外 一 个 元 素 : <bean>。<bean> 元 素 类 似 于 JavaContfig 
中 的 @Bean 注 解 。 我 们 可 以 按照 如 下 的 方式 声明 CompactDiscbean: 


<bean class="soundsystem.SgtPeppers" /> 


这 里 声明 了 一 个 很 简单 的 bean， 创 建 这 个 bean 的 类 通过 class 属 性 来 指定 
的 ， 并 且 要 使 用 全 限定 的 类 名 。 


因为 没有 明确 给 定 ID， 所 以 这 个 bean 将 会 根据 全 限定 类 名 来 进行 命名 。 





在 本 例 中 ，bean 的 ID 将 会 是 “soundsystem.SgtPeppers#6”。 其 

中 ， 人 #6” 是 一 个 计数 的 形式 ， 用 来 区 分 相同 类 型 的 其 他 bean。 如 果 你 声 
明了 另外 一 个 SgtPeppers， 并 且 没 有 明确 进行 标识 ， 那 么 它 自 动 得 到 
的 ID 将 会 是 “<soundsystem.SgtPeppers#1”。 


尽管 自动 化 的 bean 命 名 方式 非 第 方便 ， 但 如 果 你 要 稍 后 引用 它 的 话 ， 那 


目 动产 生 的 名 字 束 没有 多 大 的 用 处 了 。 因 此 ， 通 第 来 讲 更 好 的 办 法 是 借 
助 i 属性， 为 每 个 bean 设 置 一 个 你 自己 选择 的 名 字 : 

















<bean id="compactDisc" class="soundsystem.SgtPeppers" /> 





稍 后 将 这 个 bean 装 配 到 CDPlayer bean 之 中 的 时 候 ， 你 会 用 到 这 个 具体 
多 名 字 。 


减少 索 琐 为 了 减少 XML 中 沉 琐 的 配置 ， 只 对 那些 需要 按 名 字 引 用 
的 bean《〈 比 如 ， 你 需要 将 对 它 的 引用 注入 到 另外 一 个 bean 中 ) 进行 
明确 地 命名 。 


在 进一步 学 习 之 前 ， 让 我 们 花 点 时 间 看 一 下 这 个 简单 bean 声 明 的 一 些 特 
征 。 

















第 一 件 需要 注意 的 事情 就 是 你 不 再 需要 直接 人 负责 创建 SgtPeppers 的 实 
例 ， 在 基于 JavaConfig 的 配置 中 ， 我 们 是 需要 这 样 做 的 。 当 Spring 发 现 
这 个 <bean> 元 素 时 ， 它 将 会 调用 sgtPeppers 的 默认 构造 器 来 创建 
bean。 在 XML 配 置 中 ，bean 的 创建 显得 更 加 被 动 ， 不 过 ， 它 并 没有 
JavaConfig 那 样 强大 ， 在 JavaConfig 配 置 方式 中 ， 你 可 以 通过 任何 可 以 想 
象 到 的 方法 来 创建 bean 实 例 。 


男 外 一 个 需要 注意 到 的 事情 就 是 ， 在 这 个 简单 的 <bean> 声 明 中 ， 我 们 

将 bean 的 类 型 以 字符 串 的 形式 设置 在 了 class 属 性 中 。 谁 能 保证 设置 给 
class 属 性 的 值 是 真正 的 类 呢 ? Spring 的 XML 配置 并 不 能 从 编译 期 的 类 
型 检查 中 受益 。 即 便 它 所 引用 的 是 实际 的 类 型 ， 如 果 你 重 命名 了 类 ， 会 
灰 生 什 汉 上 昵 3? 


借助 IDE 检 查 XML 的 合法 性 使 用 能 够 感知 Spring 功 能 的 IDE， 如 
Spring Tool Suite， 能 够 在 很 大 程度 上 帮助 你 确保 Spring XML 配置 
的 合法 性 。 





以 上 介绍 的 只 是 JavaConfig 要 优 于 XML 配置 的 部 分 原因 。 我 建议 在 为 你 
的 应 用 选择 配置 风格 时 ， 要 记 住 XML 配置 的 这 些 缺 点 。 接 下 来 ， 我 们 
继续 Spring XML 配置 的 学 习 进 程 ， 了 解 如 何 将 SgtPeppersbean 注 入 
到 CDPlayer 之 中 。 


2.4.3 ”借助 构造 器 注入 初始 化 bean 


在 Spring XML 配置 中 ， 只 有 使 用 <beany> 元 素 并 
指定 class 属 性 。Spring 会 从 这 里 获取 必要 的 信息 来 创建 bean。 


但 是 ， 在 XML 中 声明 DI 时 ， 会 有 多 种 可 选 的 配置 方案 和 风格 。 其 体 到 
构造 器 注入 ， 有 两 种 基本 的 配置 方案 可 供 选择 : 








e <constructor- arg> 元 素 


。 使 用 Spring 3.0 所 引入 的 c- 命 名 空间 


两 者 的 区 别 在 很 大 程度 惑 是 是 人 否 隐 长 烦琐 。 可 以 看 到 ，<constructor- 
arg> 元 素 比 使 用 c- 命 名 空间 会 更 加 元 长 ， 从 而 导致 XML 更 加 难以 读 懂 。 
另外 ， 有 些 事情 <constructor-arg> 可 以 做 到 ， 但 是 使 用 c- 命 名 空间 却 
无 法 实现 。 


在 介绍 Spring XML 的 构造 器 注入 时 ， 我 们 将 会 分 别 介 绍 这 两 种 可 选 方 
案 。 首 先 ， 看 一 下 它们 各 自如 何 注 入 bean 引 用 。 


构造 器 注入 bean 引 用 


按照 现在 的 定义 ，CDPlayerbean 有 一 个 接受 CompactDisc 类 型 的 构造 
器 。 这 样 ， 我 们 就 有 了 一 个 很 好 的 场景 来 学 习 如 何 注 入 bean 的 引用 。 


现在 已 经 声明 了 SgtPeppers bean， 并 且 SgtPeppers 类 实现 了 
CompactDisc 接 口 ， 所 以 实际 上 我 们 已 经 有 了 一 个 可 以 注入 

到 CDP1ayerbean 中 的 bean。 我 们 所 需要 做 的 就 是 在 XML 中 声 

明 CDP1ayer 并 通过 ID 引用 SgtPeppers: 








<bean id="cdPlayer" class="soundsystem.CDPlayer"> 


<constructor-arg ref="compactDisc" /> 
</bean> 





当 Spring 遇 到 这 个 <bean> 元 素 时 ， 它 会 创建 一 个 CDPLayer 实 
例 。<constructor-arg> 元 系 会 告知 Spring 要 将 一 个 ID 为 compactDisc 


的 bean 引 用 传递 到 CDPlayer 的 构造 器 中 。 


作为 蔡 代 的 方案 ， 你 也 可 以 使 用 Spring 的 c- 命 名 空间 。c- 命 名 空间 是 在 
Spring 3.0 中 引入 的 ， 它 是 在 XML 中 更 为 简洁 地 描述 构造 右 参 数 的 方 
式 。 要 使 用 它 的 话 ， 必 须要 在 XML 的 顶部 声明 其 模式 ， 如 下 所 示 : 


<?xml version="1.6” encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:c="http://www.springframework.org/schema/c" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 


http://www.springframework.org/schema/beans/spring-beans.xsd"> 


</beans> 


在 c- 命 名 空间 和 模式 声明 之 后 ， 我 们 就 可 以 使 用 它 来 声明 构造 髓 参数 
了 ， 如 下 所 示 : 





<bean id="cdPlayer" class="soundsystem.CDPlayer" 


c:cd-ref="compactDisc" /> 





在 这 里 ， 我 们 使 用 了 c- 命 名 空间 来 声明 构造 器 参数 ， 它 作为 <cbean> 元 素 
的 一 个 属性 ， 不 过 这 个 属性 的 名 字 有 点 诡异 。 图 2.1 描 述 了 这 个 属性 名 
古 如 何 组 合 而 成 的 。 


构造 器 参数 名 要 注入 的 bean 的 ID 
CcC:cd-ref="compactDisc" 


Ss, 
c- 命 名 空间 前 缀 ”注入 bean 引 用 
































图 2.1 通过 Spring 的 c- 命 名 空间 将 bean 引 用 注入 到 构造 器 参数 中 
属性 名 以 <c:* 开 头 ， 也 就 是 命名 空间 的 前 级。 接 下 来 就 是 要 装配 的 构造 
器 参数 名 ， 在 此 之 后 是 “-ref”， 这 是 一 个 命名 的 约定 ， 它 会 告诉 
Spring， 正 在 装配 的 是 一 个 bean 的 引用 ， 这 个 bean 的 名 字 








是 compactDisc， 而 不 是 字面 量 “compactDisc”。 
很 显然 ， 使 用 c- 命 名 空间 属性 要 比 使 用 <constructor-arg> 元 素 简 练 得 


多 。 这 是 我 很 喜欢 它 的 原因 之 一 。 除 了 更 易 读 之 外 ， 当 我 在 编写 样 例 代 
，C- 命 名 空间 属性 能 够 更 加 有 助 于 使 代码 的 长 度 保持 在 书 的 边框 之 














在 编号 前 面 的 样 例 时 ， 关 于 c- 命 名 空间 ， 有 一 件 让 我 感到 困扰 的 事情 束 
是 它 直接 引用 了 构造 器 参数 的 名 称 。 引 用 参数 的 名 称 看 起 来 有 些 怪异 ， 

因为 这 需要 在 编译 代码 的 时 候 ， 将 调试 标志 (debug symbol) 保存 在 类 
代码 中 。 如 果 你 优化 构建 过 程 ， 将 调试 标志 移 除 挥 ， 那 么 这 种 方式 可 能 
就 无 法 正常 执行 了 。 


痊 代 的 方案 是 我 们 使 用 参数 在 整个 参数 列表 中 的 位 置信 息 : 





<bean id="cdPlayer" class="soundsystem.CDPlayer" 





c: 6-ref="compactDisc" /> 


这 个 c- 命 名 空间 属性 看 起 来 似乎 比 上 一 种 方法 更 加 怪异 。 我 将 参数 的 名 
称 符 换 成 了 “0”， 也 就 是 参数 的 索引 。 因 为 在 XML 中 不 允许 数字 作为 属 
性 的 第 一 个 字符 ， 因 此 必须 要 添加 一 个 下 面 线 作为 前 级 。 


使 用 索引 来 识别 构造 器 参数 感觉 比 使 用 名 字 更 好 一 些 。 即 便 在 构建 的 时 
候 移 除 挥 了 调试 标志 ， 参 数 却 会 依然 保持 相同 的 顺序 。 如 果 有 多 个 构造 
俐 参 数 的话 ， 这 当然 是 很 有 用 处 的 。 在 这 里 因为 只 有 一 个 构造 器 参数 ， 
所 以 我 们 还 有 男 外 一 个 方案 一 一 根本 不 用 去 标示 参数 : 





<bean id="cdPlayer" class="soundsystem.CDPlayer" 





c:_ -ref="compactDisc" /> 


到 目前 为 止 ， 这 是 最 为 奇特 的 一 个 c- 命 名 空间 属性 ， 这 里 没有 参数 索引 
或 参数 名 。 只 有 一 个 下 画 线 ， 然 后 就 是 用 “- ref” 来 表明 正在 装配 的 是 一 
六 引用 。 


我 们 已 经 将 引用 装配 到 了 其 他 的 bean 之 中 ， 接 下 来 看 一 下 如 何 将 字面 量 
值 (literal value) 装配 到 构造 器 之 中 。 


将 字面 量 注入 到 构造 器 中 





迄今 为 止 ， 我 们 所 做 的 DI 通 常 指 的 都 是 类 型 的 装配 一 -也 就 是 将 对 象 的 
引用 装配 到 依赖 于 它们 的 其 他 对 象 之 中 一 一 而 有 时 候 ， 我 们 需要 做 的 只 
是 用 一 个 字面 量 值 来 配置 对 象 。 为 了 阐述 这 一 点 ， 假 设 你 要 创建 
CompactDisc 的 一 个 新 实现 ， 如 下 所 示 : 


package soundsystem; 
public class BlankDisc implements CompactDisc { 


private String title; 
private String artist; 


public BlankDisc(String title, String artist) { 


this.title = title; 
this.artist = artist; 


} 


public void play() { 
System.out.println("Playing " + title + " by " + artist); 


} 
} 


在 SgtPeppers 中 ， 唱 片 名 称 和 艺术 家 的 名 字 都 是 便 编 码 的 ， 但 是 这 
个 CompactDisc 实 现 与 之 个 同 ， 它 更 加 灵活 。 像 现实 中 的 空 磁盘 一 样 ， 

片 名 。 现 在 ， 我 们 可 以 将 已 有 的 
SgtPeppers 蔡 换 为 这 











<bean id="compactDisc" 
class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band” /> 
<constructor-arg value="The Beatles" /> 
</bean> 





我 们 再 次 使 用 <constructor-arg> 元 素 进 行 构 造 右 参数 的 注入 。 但 是 
这 一 次 我 们 没有 使 用 “ref” 属 性 来 引用 其 他 的 bean， 而 是 使 用 了 value 属 
性 ， 通 过 该 属性 表明 给 定 的 值 要 以 字面 量 的 形式 注入 到 构造 器 之 中 。 


如 果 要 使 用 c- 命 名 空间 的 话 ， 这 个 例子 又 该 是 什么 样子 呢 ? 第 一 种 方案 
是 引用 构造 如 参数 的 名 字 : 





<bean id="compactDisc" 
class="soundsystem.BlankDisc" 


c: title="Sgt. Pepper's Lonely Hearts Club Band" 
c:_artist="The Beatles" /> 





可 以 看 到 ， 装 配 字 面 量 与 装配 引用 的 区 别 在 于 属性 名 中 去 掉 了“-ref” 后 
级 。 与 之 类 似 ， 我们 也 可 以 通过 参数 索引 装配 相同 的 字面 量 值 ， 如 下 所 
人 外: 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 


c: 0="Sgt. Pepper's Lonely Hearts Club Band" 
c:_1="The Beatles" /> 














XML 不 允许 东 个 元 系 的 多 个 属性 具有 相同 的 名 字 。 因 此 ， 如 果 有 两 个 

或 更 多 的 构造 器 参数 的 话 ， 我 们 不 能 简单 地 使 用 下 男 线 进行 标示 。 但 是 
如 果 只 有 一 个 构造 器 参数 的 话 ， 我 们 残 可 以 这 样 做 了 。 为 了 完整 地 展现 
该 功能 ， 假 设 BlankDisc 只 有 一 个 构造 器 参数 ， 这 个 参数 接受 唱片 的 名 
称 。 在 这 种 情况 下 ， 我 们 可 以 在 Spring 中 这 样 声明 它 : 


<bean id="compactDisc" class="soundsystem.BlankDisc" 





c:_ ="Sgt. Pepper's Lonely Hearts Club Band” /> 


在 装配 bean 引 用 和 字面 量 值 方面 ，<constructor-arg> 和 c- 命 名 空间 的 
功能 是 相同 的 。 但 是 有 一 种 情况 是 <constructor-arg> 能 够 实现 ，c- 命 
接 下 来 ， 让 我 们 看 一 下 如 何 将 集合 装配 到 构造 器 


装配 集合 


到 现在 为 止 ， 我 们 假设 compactDisc 在 定义 时 只 包含 了 唱片 名 称 和 艺术 
家 的 名 字 。 如 果 现 实 世 界 中 的 CD 也 是 这 样 的 话 ， 那 么 在 技术 上 就 不 会 
任何 的 进展 。CD 之 所 以 值得 购买 是 因为 它 上 面 所 承载 的 音乐 。 大 多 数 
的 CD 都 会 包含 十 多 个 磁道 ， 每 个 磁道 上 包含 一 首 歌 。 


如 果 使 用 CompactDisc 为 真正 的 CD 建 模 ， 那 么 它 也 应 该 有 磁道 列表 的 
概念 。 请 考虑 下 面 这 个 新 的 BlankDisc: 











package soundsystem.collections; 
import java.util.List; 
import soundsystem.CompactDisc; 


public class BlankDisc implements CompactDisc { 


private String title; 
private String artist; 
private List<String> tracks; 


public BlankDisc(String title, String artist, List<String> tracks) { 
this.title = title; 
this.artist artist; 
this.tracks = tracks; 


public void play() { 
System.out.println("Playing "+ title + " by " + artist); 
for (String track : tracks) { 
System.out.println("-Track: " + track); 








这 个 变更 会 对 Spring 如 何 配置 bean 产 生 影响 ， 在 声明 bean 的 时 候 ， 我 们 
必须 要 提供 一 个 磁道 列表 。 


最 简单 的 办 法 是 将 列表 设置 为 nu11。 因 为 它 是 一 个 构造 嚣 参数， 所 以 必 
须要 声明 它 ， 不 过 你 可 以 采用 如 下 的 方式 传递 hull 给 它 : 


<bean id="compactDisc" class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band” /> 


<constructor-arg value="The Beatles" /> 
<constructor-arg><null/></constructor-arg> 
</bean> 





<nul1/> 元 素 所 做 的 事情 与 你 的 期 望 是 一 样 的 :将 null 传 递 给 构造 器 。 
这 并 不 是 解决 问题 的 好 办 法 ， 但 在 注入 期 它 能 正常 执行 。 当 调 

用 play() 方 法 时 ， 你 会 遇 到 NullPointerException 异 常 ， 因 此 这 并 
不 是 理想 的 方案 。 


更 好 的 解决 方法 是 提供 一 个 磁道 名 称 的 列表 。 要 达到 这 一 点 ， 我 们 可 以 
有 多 个 可 选 方案 。 首 先 ， 可 以 使 用 <list> 元 素 将 其 声明 为 一 个 列表 : 





<bean id="compactDisc" class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band” /> 


<constructor-arg value= "The BeatJles” /> 
<constructor-arg> 
<list> 

<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 


<!-- ...other tracks omitted for brevity... --> 
</list> 
</constructor-arg> 
</bean> 





其 中 ，<1ist> 元 素 是 <constructor-arg> 的 子 元 素 ， 这 表明 一 个 包含 
0 其 中 ，<value> 元 素 用 来 指定 列表 中 的 
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与 之 类 似 ， 我 们 也 可 以 使 用 <ref> 元 素 蔡 代 <value>， 实 现 bean 引 用 列 
表 的 装配 。 例 如 ， 假 设 你 有 一 个 Discography 类 ， 它 的 构造 器 如 下 所 
a: 








public Discography(String artist, List<CompactDisc> cds) { ... } 
那么 ， 你 可 以 采取 如 下 的 方式 配置 Discography bean: 


<bean id="beatlesDiscography" 
class="soundsystem.Discography"> 
<constructor-arg value="The Beatles" /> 
<constructor-arg> 
<list> 
<ref bean="sgtPeppers" /> 
<ref bean="whiteAlbum" /> 
<ref bean="hardDaysNight" /> 
<ref bean="revolver" /> 


</list> 
</constructor-arg> 
</bean> 








当 构 造 器 参数 的 类 型 是 java .util.List 时 ， 使 用 <1ist> 元 素 是 合 情 合 
理 的 。 尺 管 如 此 ， 我 们 也 可 以 按照 同样 的 方式 使 用 <set> 元 素 : 


<bean id="compactDisc" class="soundsystem.BlankDisc"> 
<constructor-arg value="Sgt. Pepper's Lonely Hearts Club Band” /> 
<constructor-arg value="The Beatles" /> 
<constructor-arg> 
<set> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 


<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...other tracks omitted for brevity... --> 
</set> 
</constructor-arg> 
</bean> 











<set> 和 <1ist> 元 素 的 区 别 不 大 ， 其 中 最 重要 的 不 同 在 于 当 Spring 创 建 
要 装配 的 集合 时 ， 所 创建 的 是 java.util.Set 还 是 java.util.List。 
如 末 是 set 的话 ， 所 有 重复 的 值 都 会 被 名 略 掉 ， 存 放 顺 序 也 不 会 得 以 保 
证 。 不 过 无 论 在 哪 种 情况 下 ，<set> 或 <list> 都 可 以 用 来 装配 List、 
Set 甚 至 数组 。 


在 装配 集合 方面 ，<constructor-arg> 比 c- 命 名 空间 的 属性 更 有 优势 。 
目前 ， 使 用 c- 命 名 空间 的 属性 无 法 实现 装配 集合 的 功能 。 


使 用 <constructor-arg> 和 c- 命 名 空间 实现 构造 器 注入 时 ， 它 们 之 间 还 
有 一 些 细微 的 差别 。 但 是 到 目前 为 止 ， 我 们 所 涵盖 的 内 容 已 经 足够 了 ， 
尤其 是 像 我 之 前 所 建议 的 那样 ， 要 首选 基于 Java 的 配置 而 不 是 XML。 
此 ， 与 其 不 厌 其 烦 地 花费 时 间 讲 述 如 何 使 用 XML 进行 构造 器 注入 ， 还 
不 如 看 一 下 如 何 使 用 XML 来 装配 属性 。 


2.4.4 设置 属性 


到 目前 为 止 ，CDPlayer 和 BlankDisc 类 完全 是 通过 构造 器 注入 的 ， 没 
有 使 用 属性 的 Setter 方 法 。 接 下 来 ， 我 们 就 看 一 下 如 何 使 用 Spring XML 
实现 属性 注入 。 假 设 属性 注入 的 CDP1ayer 如 下 所 示 : 

















package soundsystem; 

import org.springframework.beans.factory.annotation.Autowired; 
import soundsystem.CompactDisc ; 

import soundsystem.MediaP1layer; 


public class CDPlayer implements MediaPlayer { 
private CompactDisc compactDisc ; 


@Autowired 
public void setCompactDisc(CompactDisc compactDisc) { 
this.compactDisc = compactDisc; 


} 
public void play() { 
compactDisc.play(); 


} 
} 


该 选择 构造 器 注入 还 是 属性 注入 呢 ?” 作 为 一 个 通用 的 规则 ， 我 倾 回 于 对 
强 依赖 使 用 构造 器 注入 ， 而 对 可 选 性 的 依赖 使 用 属性 注入 。 按 照 这 个 规 
则 ， 我 们 可 以 说 对 于 BlankDisc 来 讲 ， 唱 片 名 称 、 艺 术 家 以 及 磁道 列表 
是 强 依 赖 ， 因 此 构造 器 注入 是 正确 的 方案 。 不 过 ， 对 于 CDPlayer 来 
讲 ， 它 对 CompactDisc 是 强 依赖 还 是 可 选 性 依赖 可 能 会 有 些 争议 。 虽 然 
我 不 太 认 同 ， 但 你 可 能 会 党 得 即便 没有 将 CompactDisc 装 入 进 

去 ，CDP1ayer 依 然 还 能 具备 一 些 有 限 的 功能 。 


现在 ，CDPlayer 没 有 任何 的 构造 器 (除了 隐 舍 的 默认 构造 器 ) ， 它 也 
没有 任何 的 强 依赖 。 因 此 ， 你 可 以 采用 如 下 的 方式 将 其 声明 为 Spring 


bean: 








<bean id="cdPlayer" 


class="soundsystem.CDPlayer" /> 





Spring 在 创建 bean 的 时 候 不 会 有 任何 的 问题 ， 但 是 CDPlayerTest 会 因为 
出 现 NulLPointerException 而 导致 测试 失败 ， 因 为 我 们 并 没有 注 

入 CDP1ayer 的 compactDisc 属 性 。 不 过 ， 按 照 如 下 的 方式 修改 XML， 
就 能 解决 该 问题 : 


<bean id="cdPlayer" 
class="soundsystem.CDPlayer"> 


<property name="compactDisc" ref="compactDisc" /> 
</bean> 





<property> 元 素 为 属性 的 Setter 方 法 所 提供 的 功能 与 <constructor- 
arg> 元 素 为 构造 器 所 提供 的 功能 是 一 样 的 。 在 本 例 中 ， 它 引用 了 ID 
为 compactDisc 的 bean (通过 ref 属 性 ) ， 并 将 其 注入 到 compactDisc 


属性 中 《通过 setCompactDisc() 方 法 ) 。 如 果 你 现在 运行 测试 的 话 ， 
它 应 该 就 能 通过 了 。 


我 们 已 经 知道 ，Spring 为 <constructor-arg> 元 素 提 供 了 c- 命 名 空间 作 
为 蔡 代 方案 ， 与 之 类 似 ，Spring 提 供 了 更 加 简洁 的 p- 命 名 空间 ， 作 为 
<property> 元 素 的 蔡 代 方案 。 为 了 启用 p- 命 名 空间 ， 必 须要 在 XML 文 
件 中 与 其 他 的 命名 空间 一 起 对 其 进行 声明 : 


<?xml version="1.6” encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 


xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 





be 
我 们 可 以 使 用 p- 命 名 空间 ， 按 照 以 下 的 方式 装配 compactDisc 属 性 : 


<bean id="cdPlayer" 


class="soundsystem.CDPlayer" 
p:compactDisc-ref="compactDisc" /> 


P- 命 名 空间 中 属性 所 遵循 的 命名 约定 与 c- 命 名 空间 中 的 属性 类 似 。 图 2.2 








阅 述 了 p- 命 名 空间 属性 是 如 何 组 成 的 。 


属性 名 


所 注入 bean 的 ID 
| 和 ~ | 


p:CcompactDisc-ref="compactDisc" 
| 





p- 命 名 空间 前 绥 注入 bean 引 用 




















图 2.2 ”借助 Spring 的 p- 命 名 空间 ， 将 bean 引 用 注入 到 属性 中 
首先 ， 属 性 的 名 字 使 用 了 “p:” 前 级 ， 表 明 我 们 所 设置 的 是 一 个 属性 。 接 
下 来 就 是 要 注入 的 属性 名 。 最 后 ， 属 性 的 名 称 以 “-ref” 结 尾 ， 这 会 提示 
Spring 要 进行 装配 的 是 引用 ， 而 不 是 字面 量 。 


将 字面 量 注入 到 属性 中 














属性 也 可 以 注入 字面 量 ， 这 与 构造 器 参数 非常 类 似 。 作 为 示例 ， 我 们 重 
新 看 一 下 BlankDisc bean。 不 过 ，BlankDisc 这 次 完全 通过 属性 注入 进 
行 配 置 ， 而 不 是 构造 器 注入 。 新 的 BlankDisc 类 如 下 所 示 : 


package soundsystem; 


import java.util.List; 
import soundsystem.CompactDisc ; 


public class BlankDisc implements CompactDisc { 


private String title; 
private String artist; 
private List<String> tracks; 


public void setTitle(String title) { 
this.title = title; 
} 


public void setArtist(String artist) { 
this.artist = artist; 


void setTracks(List<String> tracks) { 
.tracks = tracks; 


public void play() { 
System.out.println("Playing " + title + " by " + artist); 
for (String track : tracks) { 
System.out.println("-Track: " + track); 





现在 ， 它 不 再 强制 要 求 我 们 装配 任何 的 属性 。 你 可 以 按照 如 下 的 方式 创 
建 一 个 BlankDiscbean， 它 的 所 有 属性 全 都 是 空 的 : 


<bean id="reallyBlankDisc" 


class="soundsystem.BlankDisc" /> 





当然 ， 如 果 在 装配 bean 的 时 候 不 设置 这 些 属 性 ， 那 么 在 运行 期 CD 播放 
器 将 不 能 正常 播放 内 容 。play( ) 方 法 可 能 会 遇 到 的 输出 内 容 是 “Playing 


null by null*， 随 之 会 抛 出 NullPointerException 异 常 ， 这 是 因为 我 们 
没有 指定 任何 的 磁道 。 所 以 ， 我 们 需要 装配 这 些 属性 ， 可 以 借助 
<property> 元 素 的 value 属 性 实现 该 功能 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc"> 
<property name="title" 
value="Sgt. Pepper's Lonely Hearts Club Band” /> 
<property name="artist" value="The Beatles" /> 
<property name="tracks"> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...other tracks omitted for brevity... 
</list> 
</property> 
</bean> 





在 这 里 ， 除 了 使 用 <property> 元 素 的 value 属 性 来 设置 title 和 和 
artist， 我 们 还 使 用 了 内 髓 的 <list> 元 素来 设置 tracks 属 性 ， 这 与 之 
前 通过 <constructor-arg> 装 配 tracks 是 完全 一 样 的 。 


另外 一 种 可 选 方案 就 是 使 用 p- 命 名 空间 的 属性 来 完成 该 功能 : 





<bean id="compactDisc" 
class="soundsystem.BlankDisc" 
p:title="Sgt. Pepper's Lonely Hearts Club Band" 
p:artist="The Beatles"> 
<property name="tracks"> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...other tracks omitted for brevity... 
</list> 
</property> 
</bean> 





与 c- 命 名 空间 一 样 ， 装 配 bean 引 用 与 装配 字面 量 的 唯一 区 别 在 于 是 否 市 


有 “-ref” 后 级 。 如 果 没 有 “-ref” 后 级 的 话 ， 所 装配 的 就 是 字面 量 。 
但 需要 注意 的 是 ， 我 们 不 能 使 用 p- 命 名 空间 来 装配 集合 ， 没 有 便利 的 方 
式 使 用 p- 命 名 空间 来 指定 一 个 值 〈 或 bean 引 用 ) 的 列表 。 但 是 ， 我 们 可 
以 使 用 Spring util- 命 名 空间 中 的 一 些 功 能 来 简化 BlankDiscbean。 


首先 ， 需 要 在 XML 中 声明 util- 命 名 空间 及 其 模式 : 








<?xml version="1.060" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:p="http://www.springframework.org/schema/p" 
xmlns:util="http://www.springframework.org/schema/util" 


xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/util 
http://www.springframework.org/schema/util/spring-util.xsd"> 





</beans> 


util- 命 名 空间 所 提供 的 功能 之 一 就 是 <util:1ist> 元 素 ， 它 会 创建 一 
个 列表 的 bean。 借 助 x<util:1ist>， 我 们 可 以 将 磁道 列表 转移 
到 BlankDisc bean 之 外 ， 并 将 其 声明 到 单独 的 bean 之 中 ， 如 下 所 示 : 


<util:list id="trackList"> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 
<!-- ...other tracks omitted for brevity... --> 
</util:1ist> 





现在 ， 我 们 能 够 像 使 用 其 他 的 bean 那 样 ， 将 磁道 列表 bean 注 入 
到 BlankDisc bean 的 tracks 属 性 中 : 


<bean id="compactDisc" 
class="soundsystem.BlankDisc" 


p:title="Sgt. Pepper's Lonely Hearts Club Band" 
p:artist="The Beatles" 
p:tracks-ref="trackList" /> 





<util:1list> 只 是 util- 命 名 空间 中 的 多 个 元 素 之 一 。 表 2.1 列 出 了 
util- 命 名 空间 提供 的 所 有 元 素 。 


在 需要 的 时 候 ， 你 可 能 会 用 到 util- 命 名 空间 中 的 部 分 成 员 。 但 现在 ， 
在 结束 本 章 前 ， 我 们 看 一 下 如 何 将 自动 化 配置 、JavaConfig 以 及 XML 配 
置 混合 并 匹配 在 一 起 。 








表 2.1 Spring util- 命 名 空间 中 的 元 素 


元 素 


昌 某 个 类 型 的 public static 域 ， 并 将 其 暴露 为 bean 


util:1ist 创建 一 个 java.util.List 类 型 的 bean， ! 包 含 值 或 引 月 
































创建 一 个 java Uhaudle Properties 类 型 的 bean 


util:property-path 日 一 个 bean 的 属性 (或 内 髓 属性 ) » 并 将 其 暴露 为 bean 




















创建 一 个 java util.set 类 型 的 pean， 其 中 包含 值 或 引 用 


2.5 导入 和 混合 配置 


在 典型 的 Spring 应 用 中 ， 我 们 可 能 会 同时 使 用 自动 化 和 显 式 配置 。 即 便 
你 更 喜欢 通过 JavaConfig 实 现 显 式 配置 ， 但 有 的 时 候 XML 却 是 最 佳 的 方 
案 。 


笠 好 在 Spring 中 ， 这 些 配置 方案 都 不 是 互 斥 的 。 你 尽 可 以 将 JavaConfig 

的 组 件 扫描 和 自动 装配 和 /或 XML 配置 混合 在 一 起 。 实 际 上 ， 束 像 在 

我 们 至 少 需 要 有 一 点 显 式 配置 来 启用 组 件 扫 描 和 
动 北 配 。 


关于 混合 配置 ， 第 一 件 需要 了 解 的 事情 就 是 在 自动 装配 时 ， 它 并 不 在 意 
要 闭 配 的 bean 来 自 哪 里 。 上 自动 装配 的 时 候 会 考虑 到 Spring 容 器 中 所 有 的 
bean， 不 管 它 是 在 JavaConfig 或 XML 中 声明 的 还 是 通过 组 件 扫描 获取 到 
的 。 


你 可 能 会 想 在 显 式 配 置 时 ， 比 如 在 XML 配置 和 Java 配 置 中 该 如 何 引用 
bean 呢 。 让 我 们 先 看 一 下 如 何在 JavaConfig 中 引用 XML 配置 的 bean。 











2.5.1 在 JavaConfig 中 引用 XML 配置 

现在 ， 我 们 临时 假设 CDP1ayerConfig 已 经 变 得 有 些 笨 重 ， 我 们 想 要 将 
其 进行 拆 分 。 当 然 ， 它 目前 只 定义 了 两 个 bean， 远 远 称 不 上 复杂 的 
Spring 配 置 。 不 过 ， 我 们 假设 两 个 bean 就 已 经 太 多 了 。 


我 们 所 能 实现 的 一 种 方案 就 是 将 BlankDisc 从 CDPlayerConfig 拆 分 出 
来 ， 定 义 到 它 自己 的 CDConfig 类 中 ， 如 下 所 示 : 











package soundsystem; 
import org.springframework.context.annotation.Bean; 
import org.springframework.context.annotation.Configuration; 


@Configuration 
public class CDConfig { 
@Bean 
public CompactDisc compactDisc() { 
return new SgtPeppers(); 


} 


本 


compactDisc() 方 法 已 经 从 CDP1ayerConfig 中 移 除 掉 了 ， 我 们 需要 有 
一 种 方式 将 这 两 个 类 组 合 在 一 起 。 一 种 方法 就 是 在 CDPL1ayerConfig 中 
使 用 @Import 注 解 导 入 CDConfig: 


package soundsystem; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 


@Configuration 
@Import(CDConfig.class) 


public class CDPlayerConfig { 


@Bean 
public CDP1ayer cdPlayer(CompactDisc compactDisc) { 
return new CDPlayer(compactDisc); 


} 





或 者 采用 一 个 更 好 的 办 法 ， 也 就 是 不 在 CDP1ayerConfig 中 使 
用 @Import， 而 是 创建 一 个 更 高 级 别 的 SoundsystemConfig， 在 这 个 类 
中 使 用 QImport 将 两 个 配置 类 组 合 在 一 起 : 


package soundsystem; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 


@Configuration 
@Import({CDPlayerConfig.class, CDConfig.class}) 
public class SoundSystemConfig { 


} 


不 管 采用 哪 种 方式 ， 0 
开 了 。 现 在 ， 我 们 假设 〈 基 于 某 些 原因 ) 和 希望 通过 XML 来 配 
置 BlankDisc， 如 下 所 示 : 











<bean id="compactDisc" 
class="soundsystem.BlankDisc" 
c: 0="Sgt. Pepper's Lonely Hearts Club Band" 


c: 1="The Beatles"> 

<constructor-arg> 

<list> 

<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 


<!-- ...other tracks omitted for brevity... --> 
</list> 
</constructor-arg> 
</bean> 





现在 BlankDisc 配 置 在 了 XML 之 中 ， 我 们 该 如 何 让 Spring 同时 加 载 它 和 
其 他 基于 Java 的 配置 呢 ? 


答案 是 @ImportResource 注 解 ， 假 设 BlankDisc 定 义 在 名 为 cd- 
config.xml 的 文件 中 ， 该 文件 位 于 根 类 路 径 下 ， 那 么 可 以 修 

改 SoundSystemConfig， 让 它 使 用 @ImportResource 注 解 ， 如 下 所 
小 : 





package soundsystem; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Import; 

import org.springframework.context.annotation.ImportResource; 


@Configuration 
@Import(CDPlayerConfig.class) 
@ImportResource("classpath:cd-config.xml") 
public class SoundSystemConfig { 

} 











两 个 bean 一 一 配置 在 JavaConfig 中 的 CDPlayer 以 及 配置 在 XML 中 
BlankDisc 一 一 都 会 被 加 载 到 Spring 容 器 之 中 。 因 为 CDPlayer 中 带 


有 @Bean 注 解 的 方法 接受 一 个 CompactDisc 作 为 参数 ， 因 此 BlankDisc 
将 会 装配 进来 ， 此 时 与 它 是 通过 XML 配置 的 没有 任何 关系 。 


让 我 们 继续 这 个 练习 ， 但 是 这 一 次 ， 我 们 需要 在 XML 中 引用 JavaConfig 
声明 的 bean。 





2.5.2 ”在 XML 配置 中 引用 JavaConfig 





假设 你 正在 使 用 Spring 基于 XML 的 配置 并 且 你 已 经 意识 到 XML 逐渐 变 得 
无 法 控制 。 像 前 面 一 样 ， 我 们 正在 处 理 的 是 两 个 bean， 但 事情 实际 上 会 
变 得 更 加 糟糕 。 在 被 无 数 的 尖 括 号 渡 没 之 前 ， 我 们 诀 定 将 XML 配置 文 
件 进 行 拆 分 。 


在 JavaConfig 配 置 中 ， 我 们 已 经 展现 了 如 何 使 用 QImport 和 
QImportResource 来 拆 分 JavaConfig 类 。 在 XML 中 ， 我 们 可 以 使 
用 import 元 素来 拆 分 XML 配置 。 


比如 ， 假 设 希 望 将 BlankDisc bean 拆 分 到 自己 的 配置 文件 中 ， 该 文件 名 
为 cd-config.xml， 这 与 我 们 之 前 使 用 @ImportResource 是 一 样 的 。 我 们 
可 以 在 XML 配 置 文件 中 使 用 <import> 元 素来 引用 该 文件 : 








<?xml version="1.60" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<import resource="cd-config.xml" /> 


<bean id="cdPlayer" 
class="soundsystem.CDPlayer" 
c:cd-ref="compactDisc" /> 
</beans> 





现在 ， 我 们 假设 不 再 将 BlankDisc 配 置 在 XML 之 中 ， 而 是 将 其 配置 
在 JavaConfig 中 ，CDP1ayer 则 继续 配置 在 XML 中 。 基 于 XML 的 配置 
该 如 何 引 用 一 个 JavaConfig 类 呢 ? 


事实 上 ， 答 案 并 不 那么 直观 。<import> 元 素 只 能 导入 其 他 的 XML 配置 
文件 ， 并 没有 XML 元 系 能 够 导入 JavaConfig 类 。 


但 是 ， 有 一 个 你 已 经 熟知 的 元 素 能 够 用 来 将 Java 配 置 导入 到 XML 配置 
中 : <bean> 元 素 。 为 了 将 JavaConfig 类 导入 到 XML 配置 中 ， 我 们 可 以 这 
样 声 明 bean: 





<?xml version="1.6” encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/26001/XMLSchema-instance" 
xmlns:c="http://www.springframework.org/schema/c" 


xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean class="soundsystem.CDConfig" /> 
<bean id="cdPlayer" 


class="soundsystem.CDPlayer" 
c:cd-ref="compactDisc" /> 


</beans> 





采用 这 样 的 方式 ， 两 种 配置 一 一 其 中 一 个 使 用 XML 描 述 ， 男 一 个 使 用 
Java 描 述 一 一 被 组 合 在 了 一 起 。 类 似 地 ， 你 可 能 还 希望 创建 一 个 更 高 层 
次 的 配置 文件 ， 这 个 文件 不 声明 任何 的 bean， 只 是 负责 将 两 个 或 更 多 的 
配置 组 合 起 来 。 例 如 ， 你 可 以 将 CDConfig bean 从 之 前 的 XML 文 件 中 移 
除 掉 ， 而 是 使 用 第 三 个 配置 文件 将 这 两 个 组 合 在 一 起 : 





<?xml version="1.60" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean class="soundsystem.CDConfig" /> 


<import resource="cdplayer-config.xml" /> 


</beans> 





不 管 使 用 JavaConfig 还 是 使 用 XML 进 行 装配 ， 我 通常 都 会 创建 一 个 根 配 
置 (root configuration) ， 也 就 是 这 里 展现 的 这 样 ， 这 个 配置 会 将 两 个 
或 更 多 的 装配 类 和 /或 XML 文件 组 合 起 来 。 我 也 会 在 根 配 置 中 启用 组 件 
扫描 (通过 <context:component-scan> 或 @ComponentScan) 。 你 会 


在 本 书 的 很 多 例子 中 看 到 这 种 技术 。 





2.6 ”小结 


Spring 框 架 的 核心 是 Spring 容 器 。 容 右 负 员 管 理应 用 中 组 件 的 生命 周 
期 ， 它 会 创建 这 些 组 件 并 保证 它们 的 依赖 能 够 得 到 满足 ， 这 样 的 话 ， 组 
件 才 能 完成 预定 的 任务 。 


在 本 章 中 ， 我 们 看 到 了 在 Spring 中 装配 bean 的 三 种 主要 方式 : 自动 化 配 
置 、 基 于 Java 的 显 式 配 置 以 及 基于 XML 的 显 式 配置 。 不 管 你 采用 什么 方 
式 ， 这 些 技术 都 描述 了 Spring 应 用 中 的 组 件 以 及 这 些 组 件 之 间 的 关系 。 


我 同时 建议 尽 可 能 使 用 自动 化 配置 ， 以 避免 显 式 配 置 所 带 来 的 维护 成 

本 。 但 是 ， 如 果 你 确实 需要 显 式 配置 Spring 的 话 ， 应 该 优先 选择 基于 

Java 的 配置 ， 它 比 基 于 XML 的 配置 更 加 强大 、 类 型 安全 并 且 易 于 重 构 。 
和 
九 。 











因为 依赖 注入 是 Spring 中 非常 重要 的 组 成 部 分 ， 所 以 本 章 中 介绍 的 技术 
在 本 书 中 所 有 的 地 方 都 会 用 到 。 基 于 这 些 基 础 知识 ， 下 一 章 将 会 介绍 一 
些 更 为 高 级 的 bean 装 配 技 术 ， 这 些 技术 能 够 让 你 更 加 充分 地 发 挥 Spring 
容 吉 的 威力 。 


湛 
wa 
让 
I 下 
NS 
流 
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本 章 内 容 : 


Spring profile 

条 件 化 的 bean 声 明 
自动 装配 与 歧义 性 
bean 的 作用 域 
Spring 表 达 式 语言 


在 上 一 章 中 ， 我 们 看 到 了 一 些 最 为 核心 的 bean 装 配 技 术 。 你 可 能 会 发 现 
上 一 章 学 到 的 知识 有 很 大 的 用 处 。 但 是 ，bean 闭 配 所 涉及 的 领域 并 不 仪 
仅 局 限于 上 一 章 ”所 学 习 到 的 内 容 。Spring 提 供 了 多 种 技巧 ， 借 助 它们 
可 以 实现 更 为 高 级 的 bean 装 配 功 能 。 


在 本 间 中 ， 我 们 将 会 深入 介绍 一 些 这 样 的 高 级 技术 。 本 章 中 所 介绍 的 技 
术 也 许 你 不 会 天 天 都 用 到 ， 但 这 并 不 意味 着 它们 的 价值 会 因此 而 降低 。 





3.1 环境 与 profile 


在 开发 软件 的 时 候 ， 有 一 个 很 大 的 挑战 就 是 将 应 用 程序 从 一 个 环境 迁移 
到 另外 一 个 环境 。 开 发 阶段 中 ， 某 些 环 境 相 关 做 法 可 能 并 不 适合 迁移 到 
生产 环境 中 ， 甚 至 即便 迁移 过 去 也 无 法 正 党 工作。 数据库 配置 、 加 窗 算 
法 以 及 与 外 部 系统 的 集成 是 路 环境 部 普 时 会 发 生变 化 的 几 个 典型 例子 。 


比如 ， 考 虑 一 下 数据 库 配 置 。 在 开发 环境 中 ， 我 们 可 能 会 使 用 肉 入 式 数 
据 库 ， 并 预先 加 载 测 试 数据 。 例 如 ， 在 Spring 配置 类 中 ， 我 们 可 能 会 在 
一 个 带 有 @Bean 注 解 的 方法 上 使 用 EmbeddedDatabaseBuilder: 





@Bean(destroyMethod="shutdown") 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 


.addScript("classpath:schema.sql") 
.addScript("classpath:test-data.sql") 
.build(); 





这 会 创建 一 个 类 型 为 javax.sql.DataSource 的 bean， 这 个 bean 是 如 何 
创建 出 来 的 才 是 最 有 意思 的 。 使 用 EmbeddedDatabaseBuilder 会 搭建 
一 个 藤 入 式 的 Hypersonic 数 据 库 ， 它 的 模式 (schema) 定义 在 schema.sql 
中 ， 测 试 数据 则 是 通过 test-data.sql 加 载 的 。 


当 你 在 开发 环境 中 运行 集成 测试 或 者 启动 应 用 进行 手动 测试 的 时 候 ， 这 
个 DataSource 是 很 有 用 的 。 每 次 启动 它 的 时 候 ， 都 能 让 数据 库 处 于 一 
个 给 定 的 状态 。 


尺 管 EmbeddedDatabaseBuilder 创 建 的 DataSource 非 常 适 于 开发 环 

境 ， 但 是 对 于 生产 环境 来 说 ， 这 会 是 一 个 糟 料 的 选择 。 在 生产 环境 的 配 
置 中 ， 你 可 能 会 希望 使 用 JNDI 从 容器 中 获取 一 个 Datasource。 在 这 样 
场景 中 ， 如 下 的 @Bean 方 法 会 更 加 合适 : 

















@Bean 
public DataSource dataSource() { 
JndiobJjectFactoryBean jndiObjectFactoryBean = 
new JndiObjectFactoryBean(); 
jndiObjectFactoryBean.setJndiName("jdbc/myDS"); 


jndiobJjectFactoryBean.setResourceRef(true ) ; 
jndiObjectFactoryBean.setPproxyInterface(javax.sql.DataSource.class); 
return (DataSource) jndiObjectFactoryBean.getObject(); 





通过 JNDI 获 取 DataSource 能 够 让 容器 决定 该 如 何 创 建 这 

个 Datasource， 甚 至 包括 切换 为 容 右 管理 的 连接 池 。 即 便 如 此 ，JNDI 
管理 的 DataSource 更 加 适合 于 生产 环境 ， 对 于 简单 的 集成 和 开发 测试 
环 声 来 说 ， 这 会 市 来 不 必要 的 复杂 性 。 


同时 ， 在 QA 环 境 中 ， 你 可 以 选择 完全 不 同 的 DataSource 配 置 ， 可 以 配 
置 为 Commons DBCP 连 接 池 ， 如 下 所 示 : 





@Bean(destroyMethod="close") 

public DataSource dataSource() { 
BasicDataSource dataSource = new BasicDataSource(); 
dataSource.setUrl("jdbc:h2:tcp://dbserver/~/test"); 
dataSource.setDriverClassName("org.h2.Driver"); 


dataSource.setUsername("sa"); 
dataSource.setPpassword("password"); 
dataSource.setInitialSize(20); 
dataSource.setMaxActive(308); 

return dataSource; 








显然 ， 这 里 展现 的 三 个 版 本 的 dataSource( ) 方 法 互 不 相同 。 虽 然 它 们 
都 会 生成 一 个 类 型 为 javax .sql.DataSource 的 bean， 但 它们 的 相似 点 
也 仅 限 于 此 了 。 每 个 方法 都 使 用 了 完全 不 同 的 策略 来 生成 DataSource 


bean 。 


再 次 强调 的 是 ， 这 里 的 讨论 并 不 是 如 何 配置 DataSsource 我们 将 会 在 
第 10 章 更 详细 地 讨论 这 个 话题 ) 。 看 起 来 很 简单 的 DataSource 实 际 上 
并 不 是 那么 简单 。 这 是 一 个 很 好 的 例子 ， 它 表现 了 在 不 同 的 环境 中 某 个 
bean 会 有 所 不 同 。 我 们 必须 要 有 一 种 方法 来 配置 DataSource， 使 其 在 
每 种 环境 下 都 会 选择 最 为 合适 的 配置 。 


其 中 一 种 方式 就 是 在 单独 的 配置 类 《或 XML 文件 ) 中 配置 每 个 bean， 然 
后 在 构建 阶段 〈 可 能 会 使 用 Maven 的 profiles) 确定 要 将 哪 一 个 配置 编译 
到 可 部 普 的 应 用 中 。 这 种 方式 的 问题 在 于 要 为 每 种 环境 重新 构建 应 用 。 
当 从 开发 阶段 迁移 到 QA 阶段 时 ， 重 新 构建 也 许 算 不 上 什么 大 问题 。 但 














是 ， 从 QA 阶段 迁移 到 生产 阶段 时 ， 重 新 构建 可 能 会 引入 bug 并 且 会 在 
QA 团队 的 成 员 中 带 来 不 安 的 情绪 。 


值得 庆幸 的 是 ，Spring 所 提供 的 解决 方案 并 不 需要 重新 构建 。 
3.1.1 配置 profile bean 


Spring 为 环境 相关 的 bean 所 提供 的 解决 方案 其 实 与 构建 时 的 方案 没有 太 
大 的 差别 。 妆 然 ， 在 这 个 过 程 中 需要 根据 环境 决定 该 创建 哪个 bean 和 不 
创建 哪个 bean。 不 过 Spring 并 不 是 在 构建 的 时 候 做 出 这 样 的 决策 ， 而 是 
等 到 运行 时 再 来 确定 。 这 样 的 结果 就 是 同 一 个 部 署 单 元 (可 能 会 是 
WAR 文 件 ) 能 够 适用 于 所 有 的 环境 ， 没 有 必要 进行 重新 构建 。 


在 3.1 版 本 中 ，Spring 引 入 了 bean profile 的 功能 。 要 使 用 profile， 你 首先 
要 将 所 有 不 同 的 bean 定 义 整理 到 一 个 或 多 个 profile 之 中 ， 在 将 应 用 部 署 
到 每 个 环境 时 ， 要 确保 对 应 的 profile 处 于 激活 (active〉 的 状态 。 


在 Java 配 置 中 ， 可 以 使 用 @Profile 注 解 指定 某 个 bean 属 于 哪 一 个 
on 例如 ， 在 配置 类 中 ， 钥 入 式 数 据 库 的 DataSsource 可 能 会 配置 成 
0 下 所 示 : 

















package com.myapp; 

import javax.activation.DataSource; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.context.annotation.Profile; 

ijmport 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder; 

ijmport 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType; 


@Configuration 
@Profile("dev") 
public class DevelopmentProfileConfig { 


@Bean(destroyMethod="shutdown") 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType(EmbeddedDatabaseType.H2) 
.addScript("classpath:schema.sql") 
.addScript("classpath:test-data.sql") 
.build(); 


| 


我 希望 你 能 够 注意 的 是 @Profile 注 解 应 用 在 了 类 级 别 上 。 它 会 告诉 
Spring 这 个 配置 类 中 的 bean 只 有 在 dev profile 激 活 时 才 会 创建 。 如 果 dev 
profile 没 有 激活 的 话 ， 那 么 带 有 @Bean 注 解 的 方法 都 会 被 忽略 掉 。 


同时 ， 你 可 能 还 需要 有 一 个 适用 于 生产 环境 的 配置 ， 如 下 所 示 : 


package com.myapp; 

import javax.activation.DataSource; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.Profile; 
import org.springframework.Jjndi.JndiobJjectFactoryBean ; 


@Configuration 
@Profile("prod") 
public class ProductionProfileConfig { 


@Bean 
public DataSource dataSource() { 
JndiobjectFactoryBean jndiobJjectFactoryBean = 
new JndiobJjectFactoryBean( ) ; 
jndiObjectFactoryBean.setJndiName("jdbc/myDS"); 
jndiObjectFactoryBean.setResourceRef(true); 
jndiobjectFactoryBean.setProxyInterface( 
javax.sql.DataSource.class); 
return (DataSource) jndiObjectFactoryBean.getObject(); 





在 本 例 中 ， 只 有 prod profile 激 活 的 时 候 ， 才 会 创建 对 应 的 bean。 


在 Spring 3.1 中 ， 只 能 在 类 级 别 上 使 用 @Profile 注 解 。 不 过 ， 从 Spring 
3.2 开 始 ， 你 也 可 以 在 方法 级 别 上 使 用 @Profile 注 解 ， 与 @Bean 注 解 一 
Bs 这 样 的 话 ， 就 能 将 这 两 个 bean 的 声明 放 到 同一 个 配置 类 之 中 ， 
0 下 所 示 : 


程序 清单 3.1 @Profile 注 解 基于 激活 的 profile 实 现 bean 的 装配 


package com.myapp; 

import javax.sdl.DataSource ; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.context.annotation.Profile; 

import 
org.springframework.jdbc.datasource.embedded.FEmbeddedDatabaseBuilder; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType; 

import org.springframework.jndi.JndiobjectFactoryBean:; 


@Configuration 
public class DataSourceConfig { 


@Bean (destroyMethod="shutdown") 
@Profile('"dev") 4 -为 dev profile 装配 的 bean 
public DataSource embeddqedqDataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType (EmbeddedDatabaseType.H2) 
.addSscript ("classpath: schema. sql") 
.addScript ("classpath:test-data.,sql") 





.build(); 
} 
@Bean 
@Profile ("prod") 也 为 prod profile 装配 的 bean 
public DataSource jndiDataSource() { 


JndiObjectFactoryBean jndiObjectFactoryBean = 

new JndiObjectFactoryBean(); 
JndiObjectFactoryBean.setJndiName ("jdbc/myDSs"); 
jndiOobjectFactoryBean.setResourceRef (true); 
jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class); 
return (DataSource) jndiObjectFactoryBean.getObject(); 





这 里 有 个 问题 需要 注意 ， 尽 管 每 个 DataSsource bean 都 被 声明 在 一 个 
profile 中 ， 并 且 只 有 当 规定 的 profile 激 活 时 ， 相应 的 bean 才 会 被 创建 ， 
但 是 可 能 会 有 其 他 的 bean 并 没有 声明 在 一 个 给 定 的 profile 范 围 内 。 没 有 
指定 profile 的 bean 始 终 都 会 被 创建 ， 与 激活 哪个 profile 没 有 关系 。 


在 XML 中 配置 profile 


我 们 也 可 以 通过 <beans> 元 素 的 profile 属 性 ， 在 XML 中 配置 profile 
bean。 例 如 ， 为 了 在 XML 中 定义 适用 于 开发 阶段 的 租 入 式 数据 库 
DataSourcebean， 我 们 可 以 创建 如 下 所 示 的 XML 文件 : 








<?xm] version="1.6”encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 


xmlns:jdbc="http://www.springframework.org/schema/jdbc" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/jdbc 
http://www.springframework.org/schema/jdbc/spring-jdbc.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd" 
profile="dev"> 


<jdbc:embedded-database id="dataSource"> 
<jdbc:script location="classpath:schema.sql" /> 
<jdbc:script location="classpath:test-data.sql" /> 
</jdbc:embedded-database> 
</beans> 





与 之 类 似 ， 我 们 也 可 以 将 profile 设 置 为 prod， 创 建 适用 于 生产 环境 的 
从 JNDI 获 取 的 DataSource bean。 同 样 ， 可 以 创建 基于 连接 池 定 义 的 
DataSource bean， 将 其 放 在 另外 一 个 XML 文件 中 ， 并 标注 

为 qaprofile。 所 有 的 配置 文件 都 会 放 到 部 署 单元 之 中 (如 WAR 文 件 ) ， 
FR 0 

1。 


你 还 可 以 在 根 <beans> 元 素 中 舱 套 定义 <beans> 元 素 ， 而 不 是 为 每 个 环 
境 都 创建 一 个 profile XML 文件 。 这 能 够 将 所 有 的 profile bean 定 义 放 到 同 
一 个 XML 文件 中 ， 如 下 所 示 : 


程序 清单 3.2 重复 使 用 元 素来 指定 多 个 profile 








<?xml] Version='"1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance' 
xmlns:jdbc="http://www.springframework.org/schema/jdbe" 
xmlns:jee="http://www.springframework.org/schema/jee" 
xmlns:p="http://www.springframework.org/schema/p" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/jee 
http://www.springframework.org/schema/jee/spring-jee.xsd 
http://www.springframework.org/schema/jdbc 
http://www.springframework.org/schema/jdbc/spring-jdbc.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<beans profile="dev'"> 4 . dev profile 的 bean 
<jdbc:embedded-database id="dataSource"> 
<jdbc:script location="classpath:schema.sql" /> 
<jdbc:script location="classpath:test-data.sql" /> 
</jdbc:embedded-database> 
</beans> 


<beans profile="qa'"> 4 qa profile 的 bean 
<bean id="dataSource" 

class="org.apache.commons.dbcp.BasicDataSource" 
destroy-method="close" 

:url="jdbc:h2:tcp://dbserver/~/test" 

:driverClassName="org.h2.Driver'" 

:USername='"sa" 

:password="password" 





initialSsize="20" 
maxActive="30" /> 


好 地 如 


</beans> 


<beans profile="prod"> < prod profile 的 bean 
<jee:jndi-lookup id="dataSource" 
jndi-name="jdbc/myDatabase" 
resource-ref="true" 
proxy-interface="javax.sdql.DataSource" /> 





</beans> 
</beans> 








除了 所 有 的 bean 定 义 到 了 同一 个 XML 文 件 之 中 ， 这 种 配置 方式 与 定义 在 
四 独 的 XML 文 件 中 的 实际 3 效果 是 一 样 的 。 这 里 有 三 个 bean， ， 
是 javax.sql. DataSource, 并 且 ID 都 是 dataSource。 但 是 在 运 
时 ， 只 会 创建 一 个 bean， 这 取决 于 处 于 激活 状态 的 是 哪个 Dotile 


么 问题 来 了 : 我 们 该 怎样 激活 某 个 profile 呢 ? 
3.1.2 ”激活 profile 


Spring 在 确定 哪个 profile 处 于 激活 状态 时 ， 需 要 依赖 两 个 独立 的 属 
性 : spring.profiles.active 和 spring.profiles.default。 如 果 


设置 了 spring.profiles.active 属 性 的 话 ， 那 么 它 的 值 就 会 用 来 确定 

哪个 profile 是 激活 的 。 但 如 果 没 有 设置 spring.profiles.active 属 性 

的 话 ， 那 Spring 将 会 查找 spring.profiles.default 的 值 。 如 果 

spring.profiles.active 和 spring.profiles.default 均 没有 设置 

J 那 就 没有 激活 的 profile， 因 此 只 会 创建 那些 没有 定义 在 profile 中 
bean 。 


有 多 种 方式 来 设置 这 两 个 属性 : 


。 作为 DispatcherServlet 的 初始 化 参数 ; 

。 作为 Web 应 用 的 上 下 文 参数 ; 

。 作为 JNDI 条 目 ; 

。 作为 环境 变量 ; 

。 作为 JVM 的 系统 属性 ; 

。 在 集成 测试 类 上 ， 使 用 @ActiveProfiles 注 解 设置 。 








你 尽 可 以 选择 spring.profiles.active 和 
spring.profiles.default 的 最 佳 组 合 方式 以 满足 需求 ， 我 将 这 样 的 
自主 权 留 给 读者 。 


我 所 喜欢 的 一 种 方式 是 使 用 DispatcherServlet 的 参数 

将 spring.profiles.default 设 置 为 开发 环境 的 profile， 我 会 在 Servlet 
上 下 文中 进行 设置 (为 了 兼顾 到 ContextLoaderListener) 。 例 如 ， 
在 web 应 用 中 ， 设 置 spring.profiles.default 的 web.xml 文 件 会 如 下 
所 示 : 


程序 清单 3.3 ”在 Web 应 用 的 web.xml 文 件 中 设置 默认 的 profile 


<?xml] version="1.0" encoding="UTF-8"?> 
<web-app version="2.5" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> 
<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>/WEB-INF/spring/root-context.xml</param-value> 
</context-param> 





<context-param> _ 
<param-name>spring.profiles.default</param-name> 4 为 上 下 文 设置 
<param-value>dev</param-value> 的 默认 的 profile 
</context-param> 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 


<servilet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework.web.servlet.DispatcherServlet 
</servlet-class> 
<init-param> 
<param-name>spring.profiles.default</param-name> 一 为 Servlet 设置 
<param-value>dev</param-value> 默认 的 profile 
</init-param> 
<load-on-startup>1l</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>appServlet</servlet-name> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


</web-app> 


按照 这 种 方式 设置 spring.profiles.default， 所 有 的 开发 人 员 都 能 
从 版 本 控制 软件 中 获得 应 用 程序 源码 ， 并 使 用 开发 环境 的 设置 (如 骨 入 
式 数 据 库 ) 运行 代码 ， 而 不 需要 任何 额外 的 配置 。 


当 应 用 程序 部 署 到 QA、 生 产 或 其 他 环境 之 中 时 ， 负 责 部 署 的 人 根据 情 
况 使 用 系统 属性 、 环 境 变量 或 JNDI 设 置 spring.profiles.active 即 
可 。 当 设置 spring.profiles.active 以 后 ， 至 于 
spring.profiles.default 置 成 什么 值 就 已 经 无 所 谓 了 ; 系统 会 优先 
使 用 spring.profiles.active 中 所 设置 的 profile。 

















你 可 能 已 经 注意 到 了 ， 在 spring.profiles.active 和 
spring.profiles.default 中 ，profile 使 用 的 都 是 复数 形式 。 这 意味 
着 你 可 以 同时 激活 多 个 profile， 这 可 以 通过 列 出 多 个 profile 名 称 ， 并 以 


逗号 分 隔 来 实现 。 当 然 ， 同 时 启用 dev 和 prod profile 可 能 也 没有 太 大 的 
意义 ， 不 过 你 可 以 同时 设置 多 个 彼此 不 相关 的 profile。 


使 用 profile 进 行 测试 

当 运 行 集成 测试 时 ， 通 常会 希望 采用 与 生产 环境 (或 者 是 生产 环境 的 部 
分 子 集 ) 相同 的 配置 进行 测试 。 但 是 ， 如 果 配 置 中 的 bean 定 义 在 了 
profile 中 ， 那 么 在 运行 测试 时 ， 我 们 就 需要 有 一 种 方式 来 启用 合适 的 


profile。 














Spring 提供 了 @ActiveProfiles 注 解 ， 我 们 可 以 使 用 它 来 指定 运行 测试 
时 要 激活 哪个 profile。 在 集成 测试 时 ， 通 常 想 要 激活 的 是 开发 环境 的 
profile。 例 如 ， 下 面 的 测试 类 片段 展现 了 使 用 @ActiveProfiles 激 

活 dev profile: 





@RunWith(SpringJUnit4ClassRunner .class) 
@ContextConfiguration(classes={PersistenceTestConfig.class}) 
@Activeprofiles("dev") 

public class PersistenceTest { 


人 





在 条 件 化 创建 bean 方 面 ，Spring 的 profile 机 制 是 一 种 很 棒 的 方法 ， 这 里 
的 条 件 要 基于 哪个 profile 处 于 激活 状态 来 判断 。Spring 4.0 中 提供 了 一 种 
更 为 通用 的 机 制 来 实现 条 件 化 的 bean 定 义 ， 在 这 种 机 制 之 中 ， 条 件 完 全 
由 你 来 确定 。 让 我 们 看 一 下 如 何 使 用 Spring 4 和 @Conditional 注 解 定义 
条 件 化 的 bean。 


3.2 条件 化 的 bean 


假设 你 希望 一 个 或 多 个 bean 只 有 在 应 用 的 类 路 径 下 包含 特定 的 库 时 才 创 

建 。 或 者 我 们 希望 某 个 bean 只 有 当 另 外 某 个 特定 的 bean 也 声明 了 之 后 才 

2 我 们 还 可 能 要 求 只 有 某 个 特定 的 环境 变量 设置 之 后 ， 才 会 创建 
上 bean 。 


在 Spring 4 之 前 ， 很 难 实现 这 种 级 别 的 条 件 化 配置 ， 但 是 Spring 4 引入 了 
一 个 新 的 @Conditional 注 解 ， 它 可 以 用 到 带 有 @Bean 注 解 的 方法 上 。 
如 果 给 定 的 条 件 计算 结果 为 true， 束 会 创建 这 个 bean， 人 否则 的 话 ， 这 个 
bean 会 被 忽略 。 


例如 ， 假 设 有 一 个 名 为 MagicBean 的 类 ， 我 们 希望 只 有 设置 了 magic 环 
境 属 性 的 时 候 ，Spring 才 会 实例 化 这 个 类 。 如 果 环 境 中 没有 这 个 属性 ， 
那么 MagicBean 将 会 被 忽略 。 在 程序 清单 3.4 所 展现 的 配置 中 ， 使 

用 @Conditional 注 解 条 件 化 地 配置 了 MagicBean。 


程序 清单 3.4 ”条件 化 地 配置 bean 


@Bean 
@Conditional (MagicExistsCondition.class) 
public MagicBean magicBean() { 

return new MagicBean(); 


} 
可 以 看 到 ，@Conditional 中 给 定 了 一 个 Class， 它 指明 了 条 件 一 一 在 


本 例 中 ， 也 就 是 MagicExistsCondition。@Conditional 将 会 通过 
Condition 接 口 进 行 条 件 对 比 : 




















条 件 化 地 创建 bean 


public interface Condition { 
boolean matches(ConditionContext ctxt, 


AnnotatedTypeMetadata metadata); 








设置 给 @Conditional 的 类 可 以 是 任意 实现 了 Condition 接 口 的 类 型 。 

可 以 看 出 来 ， 这 个 接口 实现 起 来 很 简单 直接 ， 只 需 提 供 matches () 方 法 
的 实现 即 可 。 如 果 matches() 方 法 返回 true， 那 么 束 会 创建 带 

有 @Conditional 注 解 的 bean。 如 果 matches() 方 法 返回 false， 将 不 会 
创建 这 些 bean。 


在 本 例 中 ， 我 们 需要 创建 Condition 的 实现 并 根据 环境 中 是 否 存 
在 magic 属 性 来 做 出 决策 。 程 序 清单 3.5 展 现 了 
MagicExistsCondition， 这 是 完成 该 功能 的 Condition 实 现 类 : 


程序 清单 3.5 ”在 Condition 中 检查 是 否 存 在 magic 属 性 


package com.habuma.restfun; 

import org.springframework.context.annotation.Condition; 

import org.springframework.context.annotation.ConditionContext; 
import org.springframework.core.type.AnnotatedTypeMetadata; 
import org.springframework.util.ClassUtils; 


public class MagicExistsCondition implements Condition { 


public boolean matches ( 
ConditionContext context, AnnotatedTypeMetadata metadata) { 
Environment env = context.getEnvironment(); 
return env.containsProperty ("magic"); 天 一 一 一 一 检查 magic 属性 
} 


} 


在 上 面 的 程序 清单 中 ，matches() 方 法 很 简单 但 功能 强大 。 它 通过 给 定 
的 ConditionContext 对 象 进而 得 到 Environment 对 象 ， 并 使 用 这 个 对 
象 检 查 环境 中 是 个 存 在 名 为 magic 的 环境 属性 。 在 本 例 中 ， 属 性 的 值 是 
什么 无 所 谓 ， 只 要 属性 存在 即 可 满足 要 求 。 如 果 满 足 这 个 条 件 的 

话 ，matches() 方 法 就 会 返回 true。 所 带 来 的 结果 就 是 条 件 能 够 得 到 满 
足 ， 所 有 @Cconditional 注 解 上 引用 MagicExistsCondition 的 bean 都 
会 被 创建 。 


话说 回来 ， 如 果 这 个 属性 不 存在 的 话 ， 就 无 法 满足 条 件 ，matches() 方 
法 会 返回 false， 这 些 bean 都 不 会 被 创建 。 




















MagicExistsCondition 中 只 是 使 用 了 ConditionContext 得 到 的 
Environment， 但 Condition 实 现 的 考量 因素 可 能 会 比 这 更 

多 。matches() 方 法 会 得 到 ConditionContext 和 
AnnotatedTypeMetadata 对 象 用 来 做 出 决策 。 


ConditionContext 是 一 个 接口 ， 大 致 如 下 所 示 : 





public interface ConditionContext { 
BeanDefinitionRegistry getRegistry(); 
ConfigurableListableBeanFactory getBeanFactory(); 
Environment getEnvironment(); 
ResourceLoader getResourceLoader(); 
ClassLoader getClassLoader(); 


D 
通过 ConditionContext， 我 们 可 以 做 到 如 下 几 点 : 


。 BSLREET SRY 回 的 BeanDefinitionRegistry 检 查 bean 定 


借助 getBeanFactory() 返 回 的 
ConfigurableListableBeanFactory 检 查 bean 是 否 存 在 ， 甚 至 探 
查 bean 的 属性 ; 

借助 getEnvironment() 返 回 的 Environment 检 查 环 境 变 量 是 否 存 
在 以 及 它 的 值 是 什么 ; 

读 取 并 探查 getResourceLoader() 返 回 的 ResourceLoader 所 加 载 
的 资源 ; 

借助 getClassLoader() 返 回 的 ClassLoader 加 载 并 检查 类 是 否 存 
年 8 


AnnotatedTypeMetadata 则 能 够 让 我 们 检查 带 有 @Bean 注 解 的 方法 上 
还 有 什么 其 他 的 注解 。 像 ConditionContext 一 
样 ，AnnotatedTypeMetadata 也 是 一 个 接口 。 它 如 下 所 示 : 











public interface AnnotatedTypeMetadata { 
boolean isAnnotated(String annotationType); 
Mapx<String, Object> getAnnotationAttributes(String annotationType); 
Mapx<String, Object> getAnnotationAttributes( 
String annotationType, boolean classValuesAsString); 


MultiValueMap<String, Object> getAllAnnotationAttributes( 
String annotationType); 

MultiValueMap<String, Object> getAllAnnotationAttributes( 
String annotationType, boolean classValuesAsString); 





借助 isAnnotated() 方 法 ， 我 们 能 够 判断 带 有 @Bean 注 解 的 方法 是 不 是 
还 有 其 他 特定 的 注解 。 借 助 其 他 的 那些 方法 ， 我 们 能 够 检查 @Bean 注 解 
的 方法 上 其 他 注解 的 属性 。 


非常 有 意思 的 是 ， 从 Spring 4 开始 ，@Profile 注 解 进行 了 重 构 ， 使 其 基 
J oconditionalhCondi tion mn 作为 如 何 使 用 @Conditional 和 
Condition 的 例子 ， 我 们 来 看 一 下 在 Spring 4 中 ，@Profile 是 如 何 实现 

的 。 


@Profile 注 解 如 下 所 示 : 


@Retention(RetentionpPolicy .RUNTIME) 
@Target({ElementType.TYPE, ElementType.METHOD}) 
@Documented 
@Conditional(ProfileCondition.class) 


public @interface Profile { 
String[] value(); 
} 








@Profile 本 身 也 使 用 了 @Conditional 注 解 ， 并 且 引 用 ProfileCondition 作 为 Condition 实 
pa eh Ee 并 且 在 做 出 决策 的 过 程 中 ， 考 虑 到 了 
ConditionContext 和 AnnotatedTypeMetadata 中 的 多 个 因素 。 




















程序 清单 3.6 ”ProfileCondition 检 查 某 个 bean profile 是 否 可 用 


class ProfileCondition implements Condition { 
public boolean matches( 
ConditionContext context, AnnotatedTypeMetadata metadata) { 
if (context.getEnvironment() != null) { 
MultiValueMap<String, Object> attrs = 
metadata.getAllAnnotationAttributes(Profile.class.getName()); 
if (attrs != null) { 
for (Object value : attrs.get("value")) { 
if (context.getEnvironment() 
.acceptsPprofiles(((String[]) value))) { 
return true; 
} 
} 
return false; 
} 
} 
return true; 
} 
} 





我 们 可 以 看 到 ，ProfileCondition 通 过 AnnotatedTypeMetadata 得 
到 了 用 于 @Profile 注 解 的 所 有 属性 。 借 助 该 信息 ， 它 会 明确 地 检查 
value 属 性 ， 该 属性 包含 了 bean 的 profile 名 称 。 然后 ， 它 根据 通过 
ConditionContext 得 到 的 Environment 来 检查 [借助 
acceptsProfiles() 方 法 ] 该 profile 是 否 处 于 激活 状态 。 


3.3 ”处理 目 动 装配 的 卜 义 性 


在 第 2 章 中 ， 我 们 已 经 看 到 如 何 使 用 目 动 装配 让 Spring 完全 负责 将 bean 引 
用 注入 到 构造 参数 和 属性 中 。 目 动 装配 能 够 提供 很 大 的 帮助 ， 因 为 它 会 
减少 装配 应 用 程序 组 件 时 所 需要 的 显 式 配置 的 数量 。 


不 过 ， 仅 有 一 个 bean 匹 配 所 需 的 结果 时 ， 目 动 装配 才 是 有 效 的 。 如 果 不 
仅 有 一 个 bean 能 够 匹配 结果 的 话 ， 这 种 歧义 性 会 阻碍 Spring 目 动 装配 属 
性 、 构 造 器 参数 或 方法 参数 。 


为 了 阐述 自动 装配 的 歧义 性 ， 假 设 我 们 使 用 @Autowired 注 解 标注 了 
setDessert() 方 法 : 














@Autowired 
public void setDessert(Dessert dessert) { 
this.dessert = dessert; 


} 


在 本 例 中 ，Dessert 是 一 个 接口 ， 并 且 有 三 个 类 实现 了 这 个 接口 ， 分 别 
为 Cake、Cookies 和 IceCream: 


@Component 
public class Cake implements Dessert { ... } 


@Component 
public class Cookies implements Dessert { ... } 
@Component 
public class IceCream implements Dessert { ... } 





因为 这 三 个 实现 均 使 用 了 @Component 注 解 ， 在 组 件 扫 描 的 时 候 ， 能 够 
发 现 它们 并 将 其 创建 为 Spring 应 用 上 下 文 里 面 的 bean。 然 后 ， 当 Spring 

试图 自动 装配 setDessert() 中 的 Dessert 参 数 时 ， 它 并 没有 唯一 、 无 
歧义 的 可 选 值 。 在 从 多 种 甜点 中 做 出 选择 时 ， 尽 管 大 多 数 人 并 不 会 有 什 
么 困难 ， 但 是 Spring 却 无 法 做 出 选择 。Spring 此 时 别 无 他 法 ， 只 好 宣告 

失败 并 抛 出 异常 。 更 精确 地 讲 ，Spring 会 抛 出 


NoUniqueBeanDefinitionException: 


nested exception is 











org.springframework.beans .factory.NoUniqueBeanDefinitionException: 
No qualifying bean of type [com.desserteater.Dessert] is defined : 
expected single matching bean but found 3: cake,cookies,iceCream 





当然 ， 使 用 吃醋 点 的 样 例 来 前 述 目 动 装配 在 遇 到 监 义 性 时 所 面临 的 问题 
多 少 有 些 牵 强 。 在 实际 中 ， 自 动 装配 歧义 性 的 问题 其 实 比 你 想象 中 的 更 
为 罕见 。 就 算 这 种 下 义 性 确实 是 个 问题 ， 但 更 常见 的 情况 是 给 定 的 类 型 
只 有 一 个 实现 类 ， 因 此 自动 装配 能 够 很 好 地 运行 。 


但 是 ， 当 确实 发 生 歧 义 性 的 时 候 ，Spring 提 供 了 多 种 可 选 方案 来 解决 这 

样 的 问题 。 你 可 以 将 可 选 bean 中 的 某 一 个 设 为 首选 〈primary) 的 bean， 

限定 符 〈qualifier) 来 帮助 Spring 将 可 选 的 bean 的 范围 缩小 到 只 
一 个 pean。 








3.3.1 标示 首选 的 bean 


如 果 你 像 我 一 样 ， 豆 欢 所 有 类 型 的 醋 点 ， 如 香 糕 、 饼 干 、 冰 诉 凑 .……… 它 
但 如 果 只 能 在 其 中 选择 一 种 甜点 的 话 ， 那 你 最 喜欢 的 是 哪 
一 种 呢 ? 


在 声明 bean 的 时 候 ， 通 过 将 其 中 一 个 可 选 的 bean 设 置 为 首选 〈primary ) 
bean 能 够 避免 自动 装配 时 的 区 义 性 。 当 遇 到 歧义 性 的 时 候 ，Spring 将 会 
而 不 是 其 他 可 选 的 bean。 实 际 上 ， 你 所 声明 就 是 “最 
喜欢 ”的 bean。 


假设 冰激凌 就 是 你 最 喜欢 的 甜点 。 在 Spring 中 ， 可 以 通过 @primary 来 表 
达 最 喜欢 的 方案 。@Primary 能 够 与 @Component 组 合用 在 组 件 扫描 的 
bean 上 ， 也 可 以 与 @Bean 组 合用 在 Java 配 置 的 bean 声 明 中 。 比 如 ， 下 面 
的 代码 展现 了 如 何 将 @Component 注 解 的 IceCream bean 声 明 为 首选 的 


bean: 














@Component 
@Primary 
public class IceCream implements Dessert { ... } 


或 者 ， 如 果 你 通过 Java 配 置 显 式 地 声明 IceCream， 那 么 QBean 方 法 应 该 
如 下 所 示 : 


@Bean 


@Primary 
public Dessert iceCream() { 
return new IceCream(); 


如 果 你 使 用 XML 配 置 bean 的 话 ， 同 样 可 以 实现 这 样 的 功能 。<bean> 元 
素 有 一 个 primary 属 性 用 来 指定 首选 的 bean: 


<bean id="iceCream" 
class="com.desserteater.IceCream" 





primary="true" /> 


不 管 你 采用 什么 方式 来 标示 首选 bean， 效 果 都 是 一 样 的 ， 都 是 告诉 
Spring 在 过 到 歧义 性 的 时 候 要 选择 首选 的 bean。 


但 是 ， 如 果 你 标示 了 两 个 或 更 多 的 首选 bean， 那 么 它 束 无 法 正常 工作 
了 。 比 如 ， 假 设 Cake 类 如 下 所 示 ; 


@Component 
@Primary 
public class Cake implements Dessert { ... } 


现在 ， 有 两 个 首选 的 Dessert bean: Cake 和 IceCream。 这 带 来 了 新 的 
歧义 性 问题 。 就 像 Spring 无 法 从 多 个 可 选 的 bean 中 做 出 选择 一 样 ， 它 也 
无 法 从 多 个 首选 的 bean 中 做 出 选择 。 显 然 ， 如 果 不 止 一 个 bean 被 设置 成 
了 首选 bean， 那 实际 上 也 就 是 没有 首选 bean 了 了 。 


焉 解决 上 收 义 性 问题 而 言 ， 限 定 符 是 一 种 更 为 强大 的 机 制 ， 下 面 束 将 对 其 





3.3.2 ”限定 目 动 装配 的 bean 


设置 首选 bean 的 局 限 性 在 于 @Primary 无 法 将 可 选 方案 的 范围 限定 到 唯 
一 一 个 无 上 疏 义 性 的 选项 中 。 它 只 能 标示 一 个 优先 的 可 选 方案 。 当 首选 
bean 的 数量 超过 一 个 时 ， 我 们 并 没有 其 他 的 方法 进一步 缩小 可 选 范围 。 


与 乙 相 反 ，Spring 的 限定 符 能 够 在 所 有 可 选 的 pean 上 进行 缩小 范围 的 操 
作 ， 最 终 能 够 达到 只 有 一 个 bean 满 足 所 规定 的 限制 条 件 。 如 果 将 所 有 的 
限定 符 都 用 上 后 依然 存在 歧义 性 ， 那 么 你 可 以 继续 使 用 更 多 的 限定 符 来 


缩小 选择 范围 。 


@Qualifier 注 解 是 使 用 限定 符 的 主要 方式 。 它 可 以 与 @Autowired 和 
@Inject 协 同 使 用 ， 在 注入 的 时 候 指 定 想 要 注入 进去 的 是 哪个 bean。 例 
如 ， 我 们 想 要 确保 要 将 IceCream 注 入 到 setDessert() 之 中 : 





@Autowired 
@Qualifier("iceCream") 


public void setDessert(Dessert dessert) { 
this.dessert = dessert; 


} 


这 是 使 用 限定 符 的 最 简单 的 例子 。 为 6QQualifier 注 解 所 设置 的 参数 就 
是 想 要 注入 的 bean 的 ID。 所 有 使 用 @Component 注 解 声明 的 类 都 会 创建 
为 bean， 并 且 bean 的 ID 为 首 字 母 变 为 小 写 的 类 名 。 因 

此 ，@Qualifier("iceCcream") 指 回 的 是 组 件 扫描 时 所 创建 的 bpean， 并 
且 这 个 bean 是 IceCream 类 的 实例 。 


实际 上 ， 还 有 一 点 需要 补充 一 下 。 更 准确 地 

讲 ，@Qualifier("iceCream") 所 引用 的 bean 要 具有 String 类 型 

的 iceCream” 作 为 限定 符 。 如 果 没 有 指定 其 他 的 限定 符 的话 ， 所 有 的 
bean 都 会 给 定 一 个 默认 的 限定 符 ， 这 个 限定 符 与 bean 的 ID 相同 。 因 此 ， 
框架 会 将 具有 “iceCream”* 限 定 符 的 bean 注 入 到 setDessert() 方 法 中 。 这 
恰巧 就 是 ID 为 iceCream 的 bean， 它 是 IceCream 类 在 组 件 扫描 的 时 候 创 
建 的 。 


基于 默认 的 bean ID 作为 限定 符 是 非常 简单 的 ， 但 这 有 可 能 会 引入 一 些 问 

题 。 如 果 你 重 构 了 IceCream 类 ， 将 其 重 命名 为 Gelato 的 话 ， 那 此 时 会 发 

生 什么 情况 呢 ? 如 果 这 样 的 话 ，bean 的 ID 和 默认 的 限定 符 会 变 

这 就 无 法 匹配 setDessert() 方 法 中 的 限定 符 。 自 动 装配 会 
败 。 


这 里 的 问题 在 于 setDessert() 方 法 上 所 指定 的 限定 符 与 要 注入 的 bean 
的 名 称 是 紧 厢 合 的 。 对 类 名 称 的 任意 改动 都 会 导致 限定 符 失 效 。 


创建 自 定 义 的 限定 符 


我 们 可 以 为 bean 设 置 自己 的 限定 符 ， 而 不 是 依赖 于 将 bean ID 作为 限定 
符 。 在 这 里 所 需要 做 的 就 是 在 bean 声 明 上 添加 @Qualifier 注 解 。 例 

















如 ， 它 可 以 与 @Component 组 合 使 用 ， 如 下 所 示 : 


@Component 


@Qualifier("cold") 
public class IceCream implements Dessert { ... } 





在 这 种 情况 下 ，cold 限 定 符 分 配给 了 IceCcreambean。 因 为 它 没有 耦合 类 
名 ， 因 此 你 可 以 随意 重 构 IceCream 的 类 名 ， 而 不 必 担 心 会 破坏 自动 装 
配 。 在 注入 的 地 方 ， 只 要 引用 cold 限 定 符 就 可 以 了 : 


@Autowired 

@Qualifier("cold") 

public void setDessert(Dessert dessert) { 
this.dessert = dessert; 





} 


值得 一 提 的 是 ， 当 通过 Java 配 置 显 式 定义 bean 的 时 候 ，Q@Qualifier 也 可 
以 与 @Bean 注 解 一 起 使 用 : 





@Bean 
@Qualifier("cold") 


public Dessert iceCream() { 
return new IceCream(); 


} 


当 使 用 自 定义 的 @Qualifier 值 时 ， 最 佳 实践 是 为 bean 选 择 特征 性 或 描 
述 性 的 术语 ， 而 不 是 使 用 随意 的 名 字 。 在 本 例 中 ， 我 将 IceCream bean 
描述 为 “cold”bean。 在 注入 的 时 候 ， 可 以 将 这 个 需求 理解 为 “给 我 一 个 深 
的 甜点 ”>， 这 其 实 就 是 描述 的 IceCream。 类 似 地 ， 我 可 以 将 Cake 描 述 

为 “soft*"， 将 Cookie 描 述 为 “crispy”。 


使 用 目 定 义 的 限定 符 注 解 
面向 特性 的 限定 符 要 比 基 于 bean ID 的 限定 符 更 好 一 些 。 但 是 ， 如 果 多 个 


bean 都 具备 相同 特性 的 话 ， 这 种 做 法 也 会 出 现 问 题 。 例 如 ， 如 果 引 入 了 
这 个 新 的 Dessert bean， 会 发 生 什 么 情况 呢 : 











@Component 


@Qualifier("cold") 
public class Popsicle implements Dessert { ... } 








不 会 吧 ? ! 现在 我 们 有 了 两 个 带 有 “cold” 限 定 符 的 甜点 。 在 自动 装配 
Dessert bean 的 时 候 ， 我 们 再 次 遇 到 了 歧义 性 的 问题 ， 需 要 使 用 更 多 的 限 
定 符 来 将 可 选 范围 限定 到 只 有 一 个 bean。 


可 能 想到 的 解决 方案 就 是 在 注入 点 和 bean 定 义 的 地 方 同时 再 添加 另外 一 
个 QQualifier 注 解 。IceCream 类 大 致 就 会 如 下 所 示 : 





@Component 
@Qualifier("cold") 


@Qualifier("creamy") 
public class IceCream implements Dessert { ... } 





Popsicle 类 同样 也 可 能 再 添加 男 外 一 个 @Qualifier 注 解 : 


@Component 

@Qualifier("cold") 

@Qualifier("fruity") 

public class Popsicle implements Dessert { ... } 





在 注入 点 中 ， 我 们 可 能 会 使 用 这 样 的 方式 来 将 范围 缩小 到 IceCream: 


@Autowired 
@Qualifier("cold") 
@Qualifier("creamy") 


public void setDessert(Dessert dessert) { 
this.dessert = dessert; 





} 


这 里 只 有 一 个 小 问题 : Java 不 允许 在 同一 个 条 目 上 重复 出 现 相 同类 型 的 
多 个 注解 。 册 如 果 你 试图 这 样 做 的 话 ， 编 译 器 会 提示 错误 。 在 这 里 ， 使 
用 @Qualifier 注 解 并 没有 办 法 (至 少 没 有 直接 的 办 法 ) 将 自动 装配 的 
可 选 bean 缩 小 范围 至 仅 有 一 个 可 选 的 bean。 


但 是 ， 我 们 可 以 创建 自 定 义 的 限定 符 注 解 ， 借 助 这 样 的 注解 来 表达 bean 
所 希望 限定 的 特性 。 这 里 所 需要 做 的 就 是 创建 一 个 注解 ， 它 本 身 要 使 
用 @Qualifier 注 解 来 标注 。 这 样 我 们 将 不 再 使 

用 @Qualifier("cold")， 而 是 使 用 自 定义 的 @Cold 注 解 ， 该 注解 的 定 
义 如 下 所 示 : 


@Target({ElementType.CONSTRUCTOR, ElementType.FIELD, 








ElementType.METHOD, ElementType.TYPE}) 
@Retention(RetentionpPolicy .RUNTIME) 
@Qualifier 
public @interface Cold { } 





同样 ， 你 可 以 创建 一 个 新 的 @Creamy 注 解 来 代替 


@Qualifier("creamy" ): 


@Target({ElementType.CONSTRUCTOR, ElementType.FIELD, 
ElementType.METHOD, ElementType.TYPE}) 

@Retention(RetentionpPolicy .RUNTIME) 

@Qualifier 

public @interface Creamy { } 





当 你 不 想 用 @Qualifier 注 解 的 时 候 ， 可 以 类 似 地 创建 @Soft、@Crispy 
和 @Fruity。 通 过 在 定义 时 添加 @Qualifier 注 解 ， 它 们 就 具有 了 
QQualifier 注 解 的 特性 。 它 们 本 身 实际 上 融 成 为 了 限定 符 注 解 。 


现在 ， 我 们 可 以 重新 看 一 下 IceCream， 并 为 其 添加 Q@Co1d 和 Q@Ccreamy 注 
解 ， 如 下 所 示 : 


@Component 

@Cold 

@Creamy 

public class IceCream implements Dessert { ... } 





类 似 地 ，Popsicle 类 可 以 添加 @Cold 和 @Fruity 注 解 : 


@Component 

@Cold 

@Fruity 

public class Popsicle implements Dessert { ... } 





最 终 ， 在 注入 点 ， 我 们 使 用 必要 的 限定 符 注解 进行 任意 组 合 ， 从 而 将 可 
选 范 围 缩 小 到 只 有 一 个 bean 满 足 需 求 。 为 了 得 到 IceCream 
bean，setDessert() 方 法 可 以 这 样 使 用 注解 : 





@Autowired 

@Cold 

@Creamy 

public void setDessert(Dessert dessert) { 


this.dessert = dessert; 
} 


通过 声明 上 自 定 义 的 限定 符 注解 ， 我 们 可 以 同时 使 用 多 个 限定 符 ， 不 会 再 
有 Java 编 译 器 的 限制 或 错误 。 与 此 同时 ， 相 对 于 使 用 原始 的 
i 目 定义 的 注解 也 更 为 类 型 
安全 。 


让 我 们 近 距 离 观察 一 下 setDessert() 方 法 以 及 它 的 注解 ， 这 里 并 没有 
在 任何 地 方 明确 指定 要 将 IceCream 自 动 装配 到 该 方法 中 。 相 反 ， 我 们 
使 用 所 需 bean 的 特性 来 进行 指定 ， 即 @Cold 和 @Creamy。 

此 ，setDessert() 方 法 依然 能 够 与 特定 的 Dessert 实 现 保持 解 厢 。 任 
意 满 足 这 些 特征 的 bean 都 是 可 以 的 。 在 当前 选择 Dessert 实 现时 ， 恰 好 
如 此 ，IceCream 是 唯一 能 够 与 之 匹配 的 bean。 


在 本 节 和 前 面 的 节 中 ， 我 们 讨论 了 儿 种 通过 自 定义 注解 扩展 Spring 的 方 
式 。 为 了 创建 自 定 义 的 条 件 化 注解 ， 我 们 创建 一 个 新 的 注解 并 在 这 个 注 
解 上 添加 了 @cConditional。 为 了 创建 自 定义 的 限定 符 注 解 ， 我 们 创建 
一 个 新 的 注解 并 在 这 个 注解 上 添加 了 @Qualifier。 这 种 技术 可 以 用 到 
很 多 spe 从 而 能 够 将 它们 组 合 在 一 起 形成 特定 目标 的 自 定 
义 注解 。 


现在 我 们 来 看 一 下 如 何在 不 同 的 作用 域 中 声明 bean。 

















3.4” ”bean 的 作用 域 


在 默认 情况 下 ，Spring 应 用 上 下 文中 所 有 bean 都 是 作为 以 单 例 
Csingleton) 的 形式 创建 的 。 也 就 是 说 ， 不 管 给 定 的 一 个 bean 被 注入 到 
其 他 bean 多 少 次 ， 每 次 所 注入 的 都 是 同一 个 实例 。 


在 大 多 数 情况 下 ， 单 例 bean 是 很 理想 的 方案 。 初 始 化 和 垃圾 回收 对 象 实 
例 所 带 来 的 成 本 只 留 给 一 些小 规模 任务 ， 在 这 些 任务 中 ， 让 对 象 保 持 无 
状态 并 且 在 应 用 中 反复 重用 这 些 对 象 可 能 并 不 合理 。 


有 时 候 ， 可 能 会 发 现 ， 你 所 使 用 的 类 是 易 变 的 (mutable) ， 它 们 会 保 
持 一 些 状态 ， 因 此 重用 是 不 安全 的 。 在 这 种 情况 下 ， 将 class 声 明 为 单 例 
的 bean 就 不 是 什么 好 主意 了 ， 因 为 对 象 会 被 污染 ， 稍 后 重用 的 时 候 会 出 
现 意 想 不 到 的 问题 。 


Spring 定义 了 多 种 作用 域 ， 可 以 基于 这 些 作用 域 创 建 bean， 包 括 : 


单 例 〈Singleton) : 在 整个 应 用 中 ， 只 创建 bean 的 一 个 实例 。 

。 原型 (Prototype) : 每 次 注入 或 者 通过 Spring 应 用 上 下 文 获取 的 时 
候 ， 都 会 创建 一 个 新 的 bean 实 例 。 

。 会 话 (Session) : 在 Web 应 用 中 ， 为 每 个 会 话 创建 一 个 bean 实 例 。 

。 请 求 (Rgquest) : 在 Web 应 用 中 ， 为 每 个 请 求 创建 一 个 bean 实 例 。 


单 例 是 默认 的 作用 域 ， 但 是 正如 之 前 所 述 ， 对 于 易 变 的 类 型 ， 这 并 不 合 
适 。 如 果 选 择 其 他 的 作用 域 ， 要 使 用 @Scope 注 解 ， 它 可 以 
与 @Component 或 @Bean 一 起 使 用 。 


例如 ， 如 果 你 使 用 组 件 扫描 来 发 现 和 声明 bean， 那 么 你 可 以 在 bean 的 类 
上 使 用 @Scope 注 解 ， 将 其 声明 为 原型 bean: 











@Component 
@Scope(ConfigurableBeanFactory .SCOPE_ PROTOTYPE) 
public class Notepad { ... } 


这 里 ， 使 用 ConfigurableBeanFactory 类 的 SCOPE_PROTOTYPE 常 量 设 
置 了 原型 作用 域 。 你 当然 也 可 以 使 用 @Scope("prototype")， 但 是 使 
用 SCOPE_PROTOTYPE 常 量 更 加 安全 并 且 不 易 出 错 。 


如 果 你 想 在 Java 配 置 中 将 Notepad 声 明 为 原型 bean， 那 么 可 以 组 合 使 
用 Q@scope 和 @Bean 来 指定 所 需 的 作用 域 ; 


@Bean 
@Scope(ConfigurableBeanFactory .SCOPE_ PROTOTYPE) 


public Notepad notepad() { 
return new Notepad(); 


} 


同样 ， 如 果 你 使 用 XML 来 配置 bean 的 话 ， 可 以 使 用 <bean> 元 系 的 scope 
属性 来 设置 作用 域 : 





<bean id="notepad" 
class="com.myapp.Notepad" 


scope="prototype”" /> 





不 管 你 使 用 哪 种 方式 来 声明 原型 作用 域 ， 每 次 注入 或 从 Spring 应 用 上 下 
文中 检索 该 bean 的 时 候 ， 都 会 创建 新 的 实例 。 这 样 所 导致 的 结果 就 是 每 
次 操作 都 能 得 到 自己 的 Notepad 实 例 。 


3.4.1 ”使 用 会 话 和 请 求 作用 域 


在 Web 应 用 中 ， 如 果 能 够 实例 化 在 会 话 和 请 求 范围 内 共 胖 的 bean， 那 将 
是 非常 有 价值 的 事情 。 例 如 ， 在 典型 的 电子 商务 应 用 中 ， 可 能 会 有 一 个 
bean 代 表 用 户 的 购物 车 。 如 果 购 物 车 是 单 例 的 话 ， 那 么 将 会 于 致 所 有 的 
用 户 都 会 癌 同 一 个 购物 车 中 添加 商品 。 另 一 方面 ， 如 果 购 物 车 是 原型 作 
用 域 的 ， 那 么 在 应 用 中 茶 一 个 地 方 往 购 物 车 中 汐 加 商品 ， 在 应 用 的 另外 
人 
购物 车 。 


束 购 物 车 bean 来 说 ， 会 话 作 用 域 是 最 为 合适 的 ， 因 为 它 与 给 定 的 用 户 关 
联 性 最 大 。 要 指定 会 话 作 用 域 ， 我 们 可 以 使 用 @Scope 注 解 ， 它 的 使 用 
方式 与 指定 原型 作用 域 是 相同 的 : 











@Component 
@Scopel 


value=WebApplicationContext.SCOPE SESSION, 
proxyMode=ScopedProxyMode.INTERFACES ) 
public ShoppingCart cart(){ ... } 





这 里 ， 我 们 将 value 设 置 成 了 WebApplicationContext 中 的 
SCOPE_SESSION 常 量 ( 它 的 值 是 session) 。 这 会 告诉 Spring 为 Web 应 
用 中 的 每 个 会 话 创建 一 个 shoppingCart。 这 会 创建 多 个 shoppingCart 
bean 的 实例 ， 但 是 对 于 给 定 的 会 话 只 会 创建 一 个 实例 ， 在 当前 会 话 相 关 
的 操作 中 ， 这 个 bean 实 际 上 相当 于 单 例 的 。 


要 注意 的 是 ，@Scope 同 时 还 有 一 个 proxyMode 属 性 ， 它 被 设置 成 了 
ScopedProxyMode .INTERFACES。 这 个 属性 解决 了 将 会 话 或 请 求 作 用 
域 的 bean 注 入 到 单 例 bean 中 所 遇 到 的 问题 。 在 描述 proxyMode 属 性 之 
前 ， 我 们 先 来 看 一 下 proxyMode 所 解决 问题 的 场景 。 


假设 我 们 要 将 ShoppingCart bean 注 入 到 单 例 StoreService bean 的 
Setter 方 法 中 ， 如 下 所 示 : 








@Component 
public class StoreService { 


@Autowired 


public void setShoppingCart(ShoppingCart shoppingCart) { 
this.shoppingCart = shoppingCart; 
} 





因为 StoreService 是 一 个 单 例 的 bean， 会 在 Spring 应 用 上 下 文 加 载 的 时 
候 创 建 。 当 它 创 建 的 时 候 ，Spring 会 试图 将 shoppingCart bean 注 入 

到 setShoppingCart() 方 法 中 。 但 是 shoppingCart bean 是 会 话 作 用 域 
的 ， 此 时 并 不 存在 。 直 到 某 个 用 户 进 入 系统 ， 创 建 了 会 话 之 后 ， 才 会 出 
现 shoppingCart 实 例 。 


另外 ， 系 统 中 将 会 有 多 个 shoppingCart 实 例 : 每 个 用 户 一 个 。 我 们 并 
不 想 让 Spring 注入 某 个 固定 的 ShoppingCart 实 例 到 StoreService 中 。 
我 们 希望 的 是 当 StoreService 处 理 购物 车 功能 时 ， 它 所 使 用 的 
ShoppingCart 实 例 恰好 是 当前 会 话 所 对 应 的 那 一 个 。 


Spring 并 不 会 将 实际 的 ShoppingCart bean 注 入 到 StoreService 中 ，Spring 
会 注入 一 个 到 shoppingCart bean 的 代理 ， 如 图 3.1 所 示 。 这 个 代理 会 景 
圳 与 SshhoppingCart 相 同 的 方法 ， 所 以 StoreService 会 认为 它 就 是 一 个 
购物 车 。 但 是 ， 当 StoreService 调 用 ShoppingCart 的 方法 时 ， 代 理会 








对 其 进行 懒 解析 并 将 调用 委托 给 会 话 作 用 域内 真正 的 ShoppingCart 


bean 。 


现在 ， 我 们 带 着 对 这 个 作用 域 的 理解 ， 讨 论 一 下 proxyMode 属 性 。 如 配 
置 所 示 ，proxyMode 属 性 被 设置 成 了 
ScopedProxyMode.INTERFACES， 这 表明 这 个 代理 要 实现 
ShoppingCart 接 口 ， 并 将 调用 委托 给 实现 bean。 


如 果 ShoppingCart 是 接口 而 不 是 类 的 话 ， 这 是 可 以 的 〈 也 是 最 为 理想 
的 代理 模式 ) 。 但 如 果 ShoppingCcart 是 一 个 具体 的 类 的 话 ，Spring 就 
没有 办 法 创建 基于 接口 的 代理 了 。 此 时 ， 它 必须 使 用 CGLib 来 生成 基于 
类 的 代理 。 所 以 ， 如 果 bean 类 型 是 具体 类 的 话 ， 我 们 必须 要 

将 proxyMode 属 性 设置 为 ScopedProxyMode .TARGET_CLASS， 以 此 来 
表明 要 以 生成 目标 类 扩展 的 方式 创建 代理 。 


尽管 我 主要 关注 了 会 话 作 用 域 ， 但 是 请 求 作 用 域 的 bean 会 面临 相同 的 并 
配 问题 。 因 此 ， 请 求 作用 域 的 bean 应 该 也 以 作用 域 代理 的 方式 进行 注 
A 











域 的 bean 
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图 3.1 ”作用 域 代理 能 够 延迟 注入 请 求 和 会 话 作 用 域 的 bean 


3.4.2 ”在 XML 中 声明 作用 域 代 理 

如 果 你 需要 使 用 XML 来 声明 会 话 或 请 求 作 用 域 的 bean， 那 么 就 不 能 使 
用 @Scope 注 解 及 其 proxyMode 属 性 了 。<bean> 元 素 的 scope 属 性 能 够 设 
置 bean 的 作用 域 ， 但 是 该 怎样 指定 代理 模式 呢 ? 


要 设置 代理 模式 ， 我 们 需要 使 用 Spring aop 命 名 空间 的 一 个 新 元 素 : 





<bean id="cart" 
class="com.myapp.ShoppingCart" 


scope="session"> 
<aop:scoped-proxy /> 
</bean> 





<aop:scoped-proxy> 是 与 @Scope 注 解 的 proxyMode 属 性 功能 相同 的 
Spring XML 配置 元 素 。 它 会 告诉 Spring 为 bean 创 建 一 个 作用 域 代 理 。 默 
认 情 况 下 ， 它 会 使 用 CGLib 创 建 目标 类 的 代理 。 但 是 我 们 也 可 以 

将 proxy-target-class 属 性 设置 为 false， 进 而 要 求 它 生成 基于 接口 
的 代理 : 


<bean id="cart" 
class="com.myapp.ShoppingCart" 
scope="session"> 
<aop:scoped-proxy proxy-target-class="false" /> 
</bean> 





为 了 使 用 <aop:scoped-proxy> 元 素 ， 我 们 必须 在 XML 配置 中 声明 
Spring 的 aop 命 名 空间 : 


<?xml version="1.6” encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/26001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


</beans> 








在 第 4 章 中 ， 当 我 们 使 用 Spring 和 面 回 切 面 编程 的 时 候 ， 会 讨论 Spring 
aop 命 名 空间 的 更 多 知识 。 不 过 ， 在 结束 本 章 的 内 容 之 前 ， 我 们 来 看 一 
下 Spring 高 级 配置 的 男 外 一 个 可 选 方案 : Spring 表 达 式 语言 (Spring 


Expression Language) 。 


3.5 ”运行 时 值 注 入 


当 讨 论 依赖 注入 的 时 候 ， 我 们 通常 所 讨论 的 是 将 一 个 bean 引 用 注入 到 为 
一 个 bean 的 属性 或 构造 器 参数 中 。 它 通常 来 讲 指 的 是 将 一 个 对 象 与 另 一 
个 对 象 进行 关联 。 


但 是 bean 装 配 的 另外 一 个 方面 指 的 是 将 一 个 值 注 入 到 bean 的 属性 或 者 构 
造 器 参数 中 。 我 们 在 第 2 章 中 已 经 进行 了 很 多 值 装配 ， 如 将 专辑 的 名 字 
装配 到 BlankDisc bean 的 构造 器 或 title 属 性 中 。 例 如 ， 我 们 可 能 按照 
这 样 的 方式 来 组 装 BlankDisc: 














@Bean 
public CompactDisc sgtPeppers() { 
return new BlankDisc( 


"Sgt. Pepper's Lonely Hearts Club Band", 
"The Beatles"); 





尽管 这 实现 了 你 的 需求 ， 也 就 是 为 BlankDisc bean 设 置 title 和 artist， 但 
它 在 实现 的 时 候 是 将 值 硬 编码 在 配置 类 中 的 。 与 之 类 似 ， 如 果 使 用 
XML 的 话 ， 那 么 值 也 会 是 便 编 码 的 : 





<bean id="sgtPeppers" 
class="soundsystem.BlankDisc" 


c: title="Sgt. Pepper's Lonely Hearts Club Band" 
c:_artist="The Beatles" /> 








有 时 候 人 硬 编码 是 可 以 的 ， 但 有 的 时 候 ， 我 们 可 能 会 希望 避免 硬 编码 值 ， 
而 是 想 让 这 些 值 在 运行 时 再 确定 。 为 了 实现 这 些 功能 ，Spring 提 供 了 两 
种 在 运行 时 求 值 的 方式 : 


。 属性 占 位 符 (Property placeholder) 。 
。 Spring 表 达 式 语言 (SpEL) 


很 快 你 就 会 发 现 这 两 种 技术 的 用 法 是 类 似 的 ， 不 过 它们 的 目的 和 行为 是 
有 所 差别 的 。 让 我 们 先 看 一 下 属性 占 位 符 ， 在 这 两 者 中 它 较 为 简单 ， 然 
后 再 看 一 下 更 为 强大 的 SpEL。 





3.5.1 注入 外 部 的 值 

在 Spring 中 ， 处 理 外 部 值 的 最 简单 方式 就 是 声明 属性 源 并 通过 Spring 的 
Environment 来 检索 属性 。 例 如 ， 程 序 清单 3.7 展 现 了 一 个 基本 的 Spring 
配置 类 ， 它 使 用 外 部 的 属性 来 装配 BlankDisc bean。 


程序 清单 3.7 使 用 @PropertySource 注 解 和 Environment 








package com.soundsystem; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 
import org.springframework.context.annotation.PropertySource; 
import org.springframework.core.env.Environment; 


@Configuration 

@PropertySource("classpath:/com/soundsystem/app.properties") 了 一 吉日 下 
声明 属性 源 

public class ExpressiveConfig { 


@Autowired 
Environment enyv; 





@Bean 
public BlankDisc disc() { 
return new BlankDisc! 
env.getProperty("disc.title"), < 一 检索 属性 值 
env.getProperty("disc.artist")); 
} 


在 本 例 中 ，@PropertySource 引 用 了 类 路 径 中 一 个 名 为 app.properties 的 
文件 。 它 大 致 会 如 下 所 示 : 


disc.title=Sgt. Peppers Lonely Hearts Club Band 
disc.artist=The Beatles 


这 个 属性 文件 会 加 载 到 Spring 的 Environment 中 ， 稍 后 可 以 从 这 里 检索 
属性 。 同 时 ， 在 disc() 方 法 中 ， 会 创建 一 个 新 的 BlankDisc， 它 的 构 
0 中 获取 的 ， 而 这 是 通过 调用 getProperty() 实 现 
和。 





深入 学 习 Spring 的 Environment 


当 我 们 去 了 解 Environment 的 时 候 会 发 现 ， 程 序 清单 3.7 所 示 的 
getProperty() 方 法 并 不 是 获取 属性 值 的 唯一 方法 ，getProperty( ) 
方法 有 四 个 重 载 的 变种 形式 : 


e String getProperty(String key) 

e String getProperty(String key, String defaultValue) 

e T getProperty(String key, Class<T> type) 

e T getProperty(String key, Class<T> type, T defaultValue) 


前 两 种 形式 的 getProperty() 方 法 都 会 返回 String 类 型 的 值 。 我 们 已 经 
在 程序 清单 3.7 中 看 到 了 如 何 使 用 第 一 种 getProperty() 方 法 。 但 是 ， 
你 可 以 稍微 对 @Bean 方 法 进行 一 下 修改 ， 这 样 在 指定 属性 不 存在 的 时 
候 ， 会 使 用 一 个 默认 值 : 





@Bean 
public BlankDisc disc() { 
return new BlankDisc( 


env.getPproperty("disc.title", "Rattle and Hum"), 
env.getPproperty("disc.artist", "U2")); 
} 





剩 下 的 两 种 getProperty() 方 法 与 前 面 的 两 种 非常 类 似 ， 但 是 它们 不 会 
将 所 有 的 值 都 视 为 String 类 型 。 例 如 ， 假 设 你 想 要 获取 的 值 所 代表 的 含 
义 是 连接 池 中 所 维持 的 连接 数量 。 如 果 我 们 从 属性 文件 中 得 到 的 是 一 个 
String 类 型 的 值 ， 那 么 在 使 用 之 前 还 需要 将 其 转换 为 Integer 类 型 。 但 

是 ， 如 果 使 用 重 载 形 式 的 getProperty() 的 话 ， 就 能 非常 便利 地 解决 这 


个 问题 : 





int connectionCount = 
env.getPproperty("db.connection.count", Integer.class, 30); 





Environment 还 提供 了 几 个 与 属性 相关 的 方法 ， 如 果 你 在 使 

用 getProperty() 方 法 的 时 候 没 有 指定 默认 值 ， 并 且 这 个 属性 没有 定义 
的 话 ， 获 取 到 的 值 是 null。 如 果 你 希望 这 个 属性 必须 要 定义 ， 那 么 可 以 
使 用 getRequiredProperty() 方 法 ， 如 下 所 示 : 

@Bean 


public BlankDisc disc() { 
return new BlankDisc( 


env.getRequiredProperty("disc.title"), 
env.getRequiredProperty("disc.artist")); 





} 


在 这 里 ， 如 果 disc .title 或 disc .artist 属 性 没有 定义 的 话 ， 将 会 抛 


出 IllegalSstateException 异 常 。 





如 果 想 检查 一 下 某 个 属性 是 否 存 在 的 话 ， 那 么 可 以 调用 Environment 的 
containsProperty() 方 法 : 





boolean titleExists = env.containsproperty("disc.title"); 


如 果 想 将 属性 解析 为 类 的 话 ， 可 以 使 用 getPropertyAsClass() 
方法 : 


Class<CompactDisc> cdClass = 





env.getPpropertyAsClass("disc.class", CompactDisc.class); 


除了 属性 相关 的 功能 以 外 ，Environment 还 提供 了 一 些 方法 来 检查 哪些 
profile 处 于 激活 状态 : 


。String[] getActiveProfiles(): 返回 激活 profile 名 称 的 数组 ; 
。String[] getDefaultProfiles(): 返回 默认 profile 名 称 的 数 
组 ; 


。 boolean acceptsProfiles(String... profiles): 如 果 
environment 支 持 给 定 profile 的 话 ， 就 返回 true。 


在 程序 清单 3.6 中 ， 我 们 已 经 看 到 了 如 何 使 用 acceptsProfiles()。 在 
那个 例子 中 ，Environment 是 从 ConditionContext 中 获取 到 的 ， 在 

bean 创 建 之 前 ， 使 用 acceptsProfiles() 方 法 来 确保 给 定 bean 所 需 的 

profile 处 于 激活 状态 。 通 党 来 讲 ， 我 们 并 不 会 频 澡 使 用 Environment 相 
关 的 方法 ， 但 是 知道 有 这 些 方 法 还 是 有 好 处 的 。 


直接 从 Environment 中 检索 属性 是 非常 方便 的 ， 尤 其 是 在 Java 配 置 中 装 
配 bean 的 时 候 。 但 是 ，Spring 也 提供 了 通过 占 位 符 装 配属 性 的 方法 ， 这 
些 占 位 符 的 值 会 来 源 于 一 个 属性 源 。 

解析 属性 占 位 符 

Spring 一 直 支 持 将 属性 定义 到 外 部 的 属性 的 文件 中 ， 并 使 用 占 位 符 值 将 
其 插入 到 Spring bean 中 。 在 Spring 装配 中 ， 占 位 符 的 形式 为 使 用 “${ 


..。 ?包装 的 属性 名 称 。 作 为 样 例 ， 我 们 可 以 在 XML 中 按照 如 下 的 方 
式 解 析 BLankDisc 构 造 器 参数 : 








<bean id="sgtPeppers" 
class="soundsystem.BlankDisc" 


c: title="${disc.title}" 
c:_ artist="${disc.artist}" /> 





可 以 看 到 ，title 构 造 器 参数 所 给 定 的 值 是 从 一 个 属性 中 解析 得 到 的 ， 
这 个 属性 的 名 称 为 disc .title。artist 参 数 装配 的 是 名 为 
disc.artist 的 属性 值 。 按 照 这 种 方式 ，XML 配 置 没有 使 用 任何 人 硬 编 
码 的 值 ， 它 的 值 是 从 配置 文件 以 外 的 一 个 源 中 解析 得 到 的 。〔( 我 们 稍 后 
会 讨论 这 些 属性 是 如 何 解析 的 。) 


如 条 我 们 依赖 于 组 件 扫 描 和 目 动 装配 来 创建 和 初始 化 应 用 组 件 的 话 ， 那 
么 束 没 有 指定 占 位 符 的 配置 文件 或 类 了 。 在 这 种 情况 下 ， 我 们 可 以 使 
用 @Value 注 解 ， 它 的 使 用 方式 与 @Autowired 注 解 非常 相似 。 比 如 ， 
在 BlankDisc 类 中 ， 构 造 器 可 以 改 成 如 下 所 未: 








public BlankDisc( 
@Value("${disc.title}") String title, 
@Value("${disc.artist}") String artist) { 


this.title = title; 
this.artist = artist; 


} 





为 了 使 用 占 位 符 ， 我 们 必须 要 配置 一 

个 PropertyPlaceholderConfigurer bean 

或 PropertySourcesPlaceholderConfigurer bean。 从 Spring 3.1 开 
始 ， 推 荐 使 用 PropertySourcesPlaceholderConfigurer， 因 为 它 能 
够 基于 Spring Environment 及 其 属性 源 来 解析 占 位 符 。 


如 下 的 @Bean 方 法 在 Java 中 配置 了 


PropertySourcesPlaceholderConfigurer: 


@Bean 
public 


static PropertySourcesPplaceholderConfigurer placeholderConfigurer() { 
return new PropertySourcesPlaceholderConfigurer(); 


} 





如 果 你 想 使 用 XML 配置 的 话 ，Spring context 命 名 空间 中 的 
<context:propertyplaceholder> 元 素 将 会 为 你 生 


成 PropertySourcesPlaceholderConfigurer bean: 


<?xml version="1.60" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:context="http://www.springframework.org/schema/context" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/beans 


http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/context 
http://www.springframework.org/schema/context/spring-context.xsd"> 


<context:property-placeholder /> 


</beans> 





解析 外 部 属性 能 够 将 值 的 处 理 推迟 到 运行 时 ， 但 是 它 的 关注 点 在 于 根据 
名 称 解析 来 自 于 Spring Environment 和 属性 源 的 属性 。 而 Spring 表达 式 
语言 提供 了 一 种 更 通用 的 方式 在 运行 时 计算 所 要 注入 的 值 。 


3.5.2 ”使 用 Spring 表达 式 语 言 进行 装配 


Spring 3 引入 了 Spring 表达 式 语 言 《Spring Expression Language， 

SpEL) ， 它 能 够 以 一 种 强大 和 简洁 的 方式 将 值 装 配 到 bean 属 性 和 构造 器 
参数 中 ， 在 这 个 过 程 中 所 使 用 的 表达 式 会 在 运行 时 计算 得 到 值 。 使 用 
SpEL， 你 可 以 实现 超 乎 想象 的 装配 效果 ， 这 是 使 用 其 他 的 装配 技术 难 
以 做 到 的 《甚至 是 不 可 能 的 ) 。 


SpEL 拥 有 很 多 特性 ， 包 括 : 


。 使 用 bean 的 ID 来 引用 bean; 

。 调用 方法 和 访问 对 象 的 属性 ; 

。 对 值 进 行 算 术 、 关 系 和 逻辑 运算 ; 
。 正则 表达 式 匹 配 ; 

。 集合 操作 。 


在 本 书后 面 的 内 容 中 你 可 以 看 到 ，SpEL 能 够 用 在 依赖 注入 以 外 的 其 他 
地 方 。 例 如 ，Spring Security 文 持 使 用 SpEL 表 达 式 定义 安全 限制 规则 。 
男 外 ， 如 果 你 在 Spring MVC 应 用 中 使 用 Thymeleaf 模 板 作 为 视图 的 话 ， 
那么 这 些 模板 可 以 使 用 SpEL 表 达 式 引用 模型 数据 。 





作为 起 步 ， 我 们 看 几 个 SpEL 表 达 式 的 样 例 ， 以 及 如 何 将 其 注入 到 bean 
中 。 然 后 我 们 会 深入 学 习 一 些 SpEL 的 基础 表达 式 ， 它 们 能 够 组 合 起 来 
形成 更 为 强大 的 表达 式 。 


SpEL 样 例 


SpEL 是 一 种 非常 灵活 的 表达 式 语言 ， 所 以 在 本 书 中 不 可 能 面面俱到 地 
介绍 它 的 各 种 用 法 。 但 是 我 们 可 以 展示 几 个 基本 的 例子 ， 这 些 例子 会 激 
发 你 的 灵感 ， 有 助 于 你 编写 自己 的 表达 式 。 


需要 了 解 的 第 一 件 事情 束 是 SpEL 表 达 式 要 放 到 震 { ..。. }” 之 中 ， 这 与 
属性 占 位 符 有 些 类 似 ， 属 性 占 位 符 需 要 放 到 “${ ... }” 之 中 。 下 面 所 
展现 的 可 能 是 最 简单 的 SpEL 表 达 式 了 : 











除去 “#{ ..。. ”标记 之 后 ， 剩 下 的 就 是 SpEL 表 达 式 体 了 ， 也 就 是 一 个 
这 个 表达 陈 的 计算 结果 就 是 数字 1， 这 恐怕 并 不 会 让 你 感到 
丝 坚 慰 讶 。 


当然 ， 在 实际 的 应 用 程序 中 ， 我 们 可 能 并 不 会 使 用 这 么 简单 的 表达 式 。 
我 们 可 能 会 使 用 更 加 有 意思 的 表达 式 ， 如 : 


#{T(System).currentTimeMillis()} 


它 的 最 终结 果 是 计算 表达 式 的 那 一 刻 当 前 时 间 的 坚 秒 数 。T() 表 达 式 会 
将 java.1lang.System 视 为 Java 中 对 应 的 类 型 ， 因 此 可 以 调用 其 static 
修饰 的 currentTimeMillis() 方 法 。 


SpEL 表 达 式 也 可 以 引用 其 他 的 bean 或 其 他 bean 的 属性 。 例 如 ， 如 下 的 表 
达 式 会 计算 得 到 ID 为 sgtPeppers 的 bean 的 artist 属 性 : 








#{sgtPeppers.artist} 


我 们 还 可 以 通过 systemProperties 对 象 引 用 系统 属性 : 


#{systemPproperties['disc.title']} 





这 只 古 SpEEL 的 几 个 基础 样 例 。 在 本 章 结 束 之 前 ， 你 还 会 看 到 很 多 这 样 
的 表达 式 。 但 是 ， 在 此 之 前 ， 让 我 们 看 一 下 在 bean 装 配 的 时 候 如 何 使 用 


如 果 通 过 组 件 扫描 创建 bean 的 话 ， 在 注入 属性 和 构造 器 参数 时 ， 我 们 可 
以 使 用 @Value 注 解 ， 这 与 之 前 看 到 的 属性 占 位 符 非常 类 似 。 不 过 ， 在 
这 里 我 们 所 使 用 的 不 是 占 位 符 表达 式 ， 而 是 SpEL 表 达 式 。 例 如 ， 下 面 
的 样 例 展 现 了 BlankDisc， 它 会 从 系统 属性 中 效 取 专辑 名 称 和 艺术 家 的 
字 : 








public BlankDisc( 
@Value("#{systemproperties['disc.title']}") String title, 
@Value("#{systemproperties['disc.artist']}") String artist) { 


this.title = title; 
this.artist = artist; 


} 


在 XML 配 置 中 ， 你 可 以 将 SpEL 表 达 式 传 入 <property> 

或 <constructor-arg> 的 value 属 性 中 ， 或 者 将 其 作为 p- 命 名 空间 或 c- 
命名 空间 条 目的 值 。 例 如 ， 在 如 下 BlankDisc bean 的 XML 声明 中 ， 构 
造 器 参数 就 是 通过 SpEL 表 达 式 设置 的 : 





<bean id="sgtPeppers" 
class="soundsystem.BlankDisc" 


c: title="#{systemProperties['disc.title’']}" 
c:_artist="#{systemProperties['disc.artist']}" /> 





我 们 已 经 看 过 了 几 个 简单 的 样 例 ， 也 学 习 了 如 何 将 SpEL 解 析 得 到 的 值 
注入 到 bean 中 ， 那 现在 就 来 继续 学 习 一 下 SpEL 所 支持 的 基础 表达 式 吧 。 


表示 字面 值 


我 们 在 前 面 已 经 看 到 了 一 个 使 用 SpEL 来 表示 整数 字面 量 的 样 例 。 它 实 
际 上 还 可 以 用 来 表示 浮 点 数 、String 值 以 及 Boolean 值 。 


下 面 的 SpEL 表 达 陈 样 例 所 表示 的 驶 是 浮 点 值 : 


#{3.14159} 


数值 还 可 以 使 用 科学 记 数 法 的 方式 进行 表示 。 如 下 面 的 表达 式 计 算得 到 
的 值 就 是 98,700: 


#{9.87E4} 





SpEL 表 达 式 也 可 以 用 来 计算 string 类 型 的 字面 值 ， 如 : 


#{'Hello'} 








Ee TE 
值 。 例 如 : 


#{false} 


在 SpEL 中 使 用 字面 值 其 实 没 有 太 大 的 意思 ， 毕 竞 将 整 型 属性 设置 为 1， 
或 者 将 Boolean 属 性 设置 为 false 时 ， 我 们 并 不 需要 使 用 SpEL。 我 承认 
在 SpEL 表 达 式 中 ， 只 包含 字面 值 情况 并 没有 太 大 的 用 处 。 但 需要 记 住 
的 一 点 是 ， 更 有 意思 的 SpEL 表 达 式 是 由 更 简单 的 表达 式 组 成 的 ， 因 此 
了 解 在 SpEL 中 如 何 使 用 字面 量 还 是 很 有 用 处 的 。 当 组 合 更 为 复杂 的 表 
达 式 时 ， 你 述 早 会 用 到 它们 。 


引用 bean、 属 性 和 方法 
SpEL 上 所 能 做 的 另外 一 件 基 础 的 事情 就 是 通过 ID 引用 其 他 的 bean。 例 


如 ， 你 可 以 使 用 SpEL 将 一 个 bean 闭 配 到 另外 一 个 bean 的 属性 中 ， 此 时 要 
使 用 bean ID 作为 SpEL 表 达 式 “〈 在 本 例 中 ， 也 区 是 sgtPeppers) : 























#{sgtPeppers} 


现在 ， 假 设 我 们 想 在 一 个 表达 式 中 引用 sgtPeppers 的 artist 属 性 : 


#{sgtPeppers.artist} 


表达 式 主体 的 第 一 部 分 引用 了 一 个 ID 为 sgtPeppers 的 bean， 分 割 符 之 
后 是 对 artist 属 性 的 引用 。 


除了 引用 bean 的 属性 ， 我 们 还 可 以 调用 bean 上 的 方法 。 例 如 ,假设 有 男 


并 


一 个 bean， 它 的 ID 为 artistSelector， 我 们 可 以 在 SpEL 表 达 式 中 按 
照 如 下 的 方式 来 调用 bean 的 selectArtist() 方 法 : 


#{artistSelector.selectArtist()} 


对 于 被 调用 方法 的 返回 值 来 说 ， 我 们 同样 可 以 调用 它 的 方法 。 例 如 ， 如 
果 selectArtist() 方 法 返回 的 是 一 个 String， 那 么 可 以 调 
用 toUpperCase() 将 整个 艺术 家 的 名 字 改 为 大 写字 母 形式 : 





#{artistSelector.selectArtist().toUpperCase()} 


如 果 selectArtist() 的 返回 值 不 是 nul1 的 话 ， 这 没有 什么 问题 。 为 了 
避免 出 现 Nul1PointerException， 我 们 可 以 使 用 类 型 安全 的 运算 符 : 


#{artistSelector.selectArtist()?.toUpperCase()} 





与 之 前 只 是 使 用 点 号 〈.) 来 访问 toUpperCase() 方 法 不 同 ， 现 在 我 们 
使 用 了 “?.” 运 算 符 。 这 个 运算 符 能 够 在 访问 它 右 边 的 内 容 之 前 ， 确 保 它 
所 对 应 的 元 素 不 是 nul1。 所 以 ， 如 果 selectArtist() 的 返回 值 是 nul1 
的 话 ， 那 么 SpEL 将 不 会 调用 toUpperCase() 方 法 。 表 达 式 的 返回 值 会 


是 null。 
在 表达 式 中 使 用 类 型 
如 果 要 在 SpEL 中 访问 类 作用 域 的 方法 和 和 党 量 的 话 ， 要 依赖 T() 这 个 关键 


的 运算 符 。 例 如 ， 为 了 在 SpEL 中 表达 Java 的 Math 类 ， 需 要 按照 如 下 的 
方式 使 用 T() 运 算 符 : 





T(java.lang.Math) 


这 里 所 示 的 T() 运 算 符 的 结果 会 是 一 个 Class 对 象 ， 代 表 了 
java.lang.Math。 如 果 需 要 的 话 ， 我 们 甚至 可 以 将 其 装配 到 一 

个 Class 类 型 的 bean 属 性 中 。 但 是 T() 运 算 符 的 真正 价值 在 于 它 能 够 访 
问 目 标 类 型 的 静态 方法 和 常量 。 


0 假如 你 需要 将 PI 值 装配 到 bean 属 性 中 。 如 下 的 SpEL 束 能 完成 该 任 











T(Jjava.lang.Math ) .PI 


与 之 类 似 ， 我 们 可 以 调用 T() 运 算 符 所 得 到 类 型 的 静态 方法 。 我 们 已 经 
看 到 了 通过 T() 调 用 System.currentTimeMil1is()。 如 下 的 这 个 样 例 
会 计算 得 到 一 个 0 到 1 之 间 的 随机 数 : 


T(java.lang.Math) .random() 


SpEL 运 算 符 


SpEL 提 供 了 多 个 运算 符 ， 这 些 运算 从 可 以 用 在 SpEL 表 达 式 的 值 上 。 表 
3.1 概 述 了 这 些 运 算 符 。 


表 3.1 用 来 操作 表达 式 值 的 SpEL 运 算 符 














算术 运算 


运 入 Ss 
比较 运算 S 
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运算 符 类 型 














>、 、 <=、>=、]t、gt、eq、Jle、&ge 


作为 使 用 上 述 运 算得 的 一 个 简单 样 例 ， 我 们 看 一 下 下 面 这 个 SpEL 表 达 


起 











#{2 * T(java.lang.Math).PI * circle.radius} 


这 不 仅 是 使 用 SpEL 中 乘法 运算 符 (*) 的 绝 佳 样 例 ， 它 也 为 你 展现 了 如 
何 将 简单 的 表达 式 组 合 为 更 为 复 茶 的 表达 式 。 在 这 里 PI 的 值 乘 以 2， 然 


后 再 乘 以 radius 属 性 的 值 ， 这 个 属性 来 源 于 ID 为 circle 的 bean。 实 际 
上 ， 它 计算 了 circle bean 中 所 定义 圆 的 周 长 。 


类 似 地 ， 你 还 可 以 在 表达 式 中 使 用 乘 方 运算 符 〈^) 来 计算 圆 的 面积 : 


“是 用 于 对方 计算 的 运算 答 。 在 本 例 中 ， 我 们 使 用 它 来 计 算 国 半径 的 
平方 


O 


当 String 类 型 的 值 时 , “+? 运 算 符 执行 的 是 连接 操作 ， 与 在 Java 中 是 


#{disc.title + ' by ' + disc.artist} 


SpEL 同 时 还 提供 了 比较 运算 符 ， 用 来 在 表达 陈 中 对 值 进行 对 比 。 注 意 
在 表 3.1 中 ， 比 较 运 算 符 有 两 种 形式 : 符号 形式 和 文本 形式 。 在 大 多 数 
和 使 用 哪 一 种 形 
式 均 可 以 。 


例如 ， 要 比较 两 个 数字 是 不 是 相等 ， 可 以 使 用 双 等 扎 运 算 符 (==) : 
或 者 ， 也 可 以 使 用 文本 型 的 eq 运算 符 : 


#{counter.total eq 166} 


两 种 方式 的 结果 都 是 一 样 的 。 表 达 式 的 计算 结果 是 个 Boolean 值 : 如果 
counter .total 等 于 100 的 话 ， 为 true， 人 否则 为 false。 














SpEL 还 提供 了 三 元 运算 符 (ternary) ， 它 与 Java 中 的 三 元 运算 符 非常 类 
似 。 例 如 ， 如 下 的 表达 式 会 判断 如 果 scoreboard.score>1668 的 话 ， 
计算 结果 为 String 类 型 的 “Winner! ”， 否则 的 话 ， 结 果 为 Loser: 


#{scoreboard.score > 1666 »? "Winner!"” : "Loser"} 





三 元 运算 符 的 一 个 常见 场景 束 是 检查 nul1 值 ， 并 用 一 个 默认 值 来 蔡 代 


nul1。 例 如 ， 如 下 的 表达 式 会 判断 disc.title 的 值 是 不 是 nul1， 如 果 
是 nul1 的 话 ， 那 么 表达 式 的 计算 结果 就 会 是 “Rattle and Hum”: 


#{disc.title ?: "Rattle and Hum'} 


这 种 表达 式 通 第 称 为 Elvis 运 算 符 。 这 个 奇怪 名 称 的 来 历 是 ， 当 使 用 符号 
来 表示 表情 时 ， 问 号 看 起 来 很 像 是 猫 王 “Elvis Presley) 的 头发 。 


计算 正则 表达 式 


当 处 理 文本 时 ， 有 时 检查 文本 是 否 匹 配 某 种 模式 是 非常 有 用 的 。SpEL 
通过 matches 运 算 符 文 持 表 达 式 中 的 模式 匹配 。matches 运 算 符 对 String 
类 型 的 文本 《作为 左边 参数 ) 应 用 正则 表达 式 〈 作 为 右边 参 

数 ) 。matches 的 运算 结果 会 返回 一 个 Boolean 类 型 的 值 : 如 果 与 正则 表 
达 式 相 匹配 ， 则 返回 true; 否则 返回 false。 


为 了 进一步 解释 matches 运 算 符 ， 假 设 我 们 想 判 断 一 个 字符 串 是 个 包含 
人 在 这 个 场景 下 ， 我 们 可 以 使 用 matches 运 算 符 ， 如 下 
人 小: 














#{admin.email matches '[a-zA-Z6-9. %+-]+@[a-zA-Z260-9.-]+\\.com'} 





探寻 正则 表达 式 语 法 的 秘密 超出 了 本 书 的 范围 ， 同 时 我 们 也 应 该 意识 到 
这 里 的 正则 表达 式 还 不 足够 健壮 来 涵盖 所 有 的 场景 。 但 对 于 演 

示 matches 运 算 符 的 用 法 ， 这 已 经 足够 了 。 

计算 集合 


SpEL 中 最 令 人 惊奇 的 一 些 技巧 是 与 集合 和 数组 相关 的 。 基 简单 的 事情 
可 能 就 是 引用 列表 中 的 一 个 元 系 了 : 


#{jukebox.songs[4].title} 


这 个 表达 式 会 计算 songs 集 合 中 第 五 个 〈 基 于 零 开 始 ) 元 素 的 title 属 
性 ， 这 个 集合 来 源 于 ID 为 jJukebox bean。 


ee 假设 我 们 要 从 jukebox 中 随机 选择 一 首 
了 歌 : 


#{jukebox.songs[T(java.lang.Math).random() * 
jukebox.songs.size()].title} 





“[]” 运 算 符 用 来 从 集合 或 数组 中 按照 索引 获取 元 素 ， 实 际 上 ， 它 还 可 以 
从 String 中 获取 一 个 字符 。 比 如 : 


#{'This is a test'[3]} 


这 个 表达 式 引 用 了 String 中 的 第 四 个 (基于 零 开 始 〉 字符 ， 也 就 
[三 | “%S2” [2] 


但 


SpEL 还 提供 了 查询 运算 符 (.?[]) ， 它 会 用 来 对 集合 进行 过 滤 ， 得 到 
集合 的 一 个 子 集 。 作 为 曾 述 的 样 例 ， 假 设 你 希望 得 到 jukebox 中 artist 
性 为 Aerosmith 的 所 有 歌曲 。 如 下 的 表达 式 束 使 用 查询 运算 符 得 到 了 
Aerosmith 的 所 有 歌曲 : 


再 


#{jukebox.songs.?[artist eq 'Aerosmith']} 


可 以 看 到 ， 选 择 运 算 符 在 它 的 方 括号 中 接受 另 一 个 表达 式 。 当 SpEL 和 迭 

代 歌 曲 列表 的 时 候 ， 会 对 歌曲 集合 中 的 每 一 个 条 目 计 算 这 个 表达 式 。 如 
果 表 达 式 的 计算 结果 为 true 的 话 ， 那 么 条 目 会 放 到 新 的 集合 中 。 否 则 的 
话 ， 它 就 不 会 放 到 新 集合 中 。 在 本 例 中 ， 内 部 的 表达 式 会 检查 歌曲 的 

artist 属 性 是 不 是 等 于 Aerosmith。 


SpEL 还 提供 了 另外 两 个 查询 运算 符 : “.^[]” 和 “.$[]”， 它 们 分 别 用 来 
壬 集 合 中 查询 第 一 个 匹配 项 和 最 后 一 个 匹配 项 。 例如， 考虑 下 面 的 表达 
式 ， 它 会 查找 列表 中 第 一 个 artist 属 性 为 Aerosmith 的 歌曲 : 


#{jukebox.songs.^[artist eq "Aerosmith ']} 


最 后 ，SpEL 还 提供 了 投影 运算 符 〈.![]) ， 它 会 从 集合 的 每 个 成 员 中 
选择 特定 的 属性 放 到 另外 一 个 集合 中 。 作 为 样 例 ， 假 设 我 们 不 想 要 歌曲 
对 象 的 集合 ， 而 是 所 有 歌曲 名 称 的 集合 。 如 下 的 表达 式 会 将 title 属 性 
投影 到 一 个 新 的 String 类 型 的 集合 中 : 











从 


#{jukebox.songs.![title]} 


实际 上 ， 投 影 操 作 可 以 与 其 他 任意 的 SpEL 运 算 符 一 起 使 用 。 比 如 ， 我 
们 可 以 使 用 如 下 的 表达 式 获得 Aerosmith 所 有 歌曲 的 名 称 列表 : 


#{jukebox.songs.?[artist eq 'Aerosmith'].![title]} 


我 们 所 介绍 的 只 是 SpEL 功 能 的 一 个 皮毛 。 在 本 书 中 还 有 更 多 的 机 会 继 
续 介 绍 SpEL， 尤 其 是 在 定义 安全 规则 的 时 候 。 


现在 对 SpEEL 的 介绍 要 告 一 段落 了 ， 不 过 在 此 之 前 ， 我 们 有 一 个 提示 。 
在 动态 注入 值 到 Spring bean 时 ，SpEL 是 一 种 很 便利 和 强大 的 方式 。 我 们 
有 时 会 忍 不 住 编 写 很 复杂 的 表达 式 。 但 需要 注意 的 是 ， 不 要 让 你 的 表达 
式 太 智能 。 你 的 表达 式 越 智能 ， 对 它 的 测试 就 越 重 要 。SpEL 毕 竟 只 是 
String 类 型 的 值 ， 可 能 测试 起 来 很 困难 。 鉴 于 这 一 点 ， 我 建议 尽 可 能 让 
表达 式 保持 简洁 ， 这 样 测 试 不 会 是 什么 大 问题 。 











3.6 ”小结 


我 们 在 本 章 介 绍 了 许多 背景 知识 ， 在 第 2 章 所 介绍 的 基本 bean 闭 配 基础 
之 上 ， 又 学 习 了 一 些 强大 的 高 级 装配 技巧 。 


首先 ， 我 们 学 习 了 Spring profile， 它 解决 了 Spring bean 要 跨 各 种 部 署 环 
卉 的 通用 问题 。 在 运行 时 ， 通 过 将 环境 相关 的 bean 与 当前 激活 的 profile 
进行 匹配 ，Spring 能 够 让 相同 的 部 署 单元 路 多 种 环境 运行 ， 而 不 需要 进 
行 重新 构建 。 


Profile bean 是 在 运行 时 条 件 化 创建 bean 的 一 种 方式 ， 但 是 Spring 4 提供 了 
一 种 更 为 通用 的 方式 ， 通 过 这 种 方式 能 够 声明 某 些 bean 的 创建 与 谷 要 依 
赖 于 给 定 条 件 的 输出 结果 。 结 合 使 用 @Conditional 注 解 和 Spring 
Condition 接 口 的 实现 ， 能 够 为 开发 人 员 提 供 一 种 强大 和 灵活 的 机 制 ， 
实现 条 件 化 地 创建 bean。 


我 们 还 看 了 两 种 解决 目 动 装配 歧义 性 的 方法 : 首选 bpean 以 及 限定 符 。 尽 
管 将 茶 个 bean 设 置 为 首选 bean 古 很 简单 的 ， 但 这 种 方式 也 有 其 局 限 性 ， 

所 以 我 们 讨论 了 如 何 将 一 组 可 选 的 自动 效 配 bean， 借 助 限定 符 将 其 范围 
缩小 到 只 有 一 个 符合 条 件 的 bean。 除 此 之 外 ， 我 们 还 看 到 了 如 何 创 建 自 
定义 的 限定 符 注 解 ， 这 些 限定 符 描述 了 bean 的 特性 。 


尽管 大 多 数 的 Spring bean 都 是 以 单 例 的 方式 创建 的 ， 但 有 的 时 候 其 他 的 
创建 策略 更 为 合适 。Spring 能 够 让 bean 以 单 例 、 原 型 、 请 求 作 用 域 或 会 
话 作 用 域 的 方式 来 创建 。 在 声明 请 求 作 用 域 或 会 话 作 用 域 的 bean 的 时 
候 ， 我 们 还 学 习 了 如 何 创建 作用 域 代 理 ， 它 分 为 基于 类 的 代理 和 基于 接 
口 的 代理 的 两 种 方式 。 


最 后 ， 我 们 学 习 了 Spring 表达 式 语言 ， 它 能 够 在 运行 时 计算 要 注入 到 
bean 属 性 中 的 值 。 


对 于 bean 装 配 ， 我 们 已 经 掌握 了 扎实 的 基础 知识 ， 现 在 我 们 要 将 注意 力 
转 同 面 癌 切面 编程 〈aspect-oriented programming ，AOP) 了。 依赖 注 入 
能 够 将 组 件 及 其 协作 的 其 他 组 件 解 厢 ， 与 之 类 似 ，AOP 有 助 于 将 应 用 组 
件 与 跨 多 个 组 件 的 任务 进行 解 厢 。 在 下 一 章 ， 我 们 将 会 深入 学 习 在 
Spring 中 如 何 创 建 和 使 用 切面 。 

















[1]Java 8 允许 出 现 重复 的 注解 ， 只 要 这 个 注解 本 身 在 定义 的 时 候 带 
有 @Repeatable 注 解 就 可 以 。 不 过 ，Spring 的 @Qualifier 注 解 并 没有 在 
定义 时 添加 @Repeatable 注 解 。 


[2] 不 要 责怪 我 ， 我 不 太 认同 这 个 名 字 。 但 是 我 必须 承认 ， 它 看 起 来 确实 
有 点 像 猫 王 的 头发 。 


第 4 草 面 问 切面 的 Spring 
本 章 内 容 : 


。 面向 切面 编程 的 基本 原理 
。 通过 POJO 创 建 切面 

。 使 用 @AspectJ 注 解 

。 为 AspectJ 切 面 注入 依赖 


在 编写 本 草 时 ， 得 殉 院 斯 州 《我 所 居住 的 地 方 ) 正 值 盛夏 ， 这 几 天 正在 
经 历 创 历史 记录 的 高 温 天 气 。 这 里 真 的 非常 热 ， 在 这 种 天 气 下 ， 空 调 当 
然 是 必 不 可 少 的 。 但 是 空调 的 缺点 是 它 会 耗 电 ， 而 电 需 要 钱 。 为 了 享受 
次 亚 和 千 适 ， 我 们 没有 什么 办 法 可 以 避免 这 种 开销 。 这 是 因为 每 家 每 户 
都 有 一 个 电表 来 记录 用 电量 ， 每 个 月 都 会 有 人 来 得 电表 ， 这 样 电 力 公司 
就 知道 应 该 收取 多 少 宽 用 了 。 


现在 想象 一 下 ， 如 条 没有 电表 ， 也 没有 人 来 查看 用 电量 ， 假 设 现在 由 户 
主 来 联系 电力 公司 并 报告 自己 的 用 电量 。 虽 然 可 能 会 有 一 些 特别 执着 的 
户主 会 详细 记录 使 用 电灯 、 电 视 和 空调 的 情况 ， 但 大 多 数 人 肯定 不 会 这 
么 做 。 基 于 信用 的 电力 收费 对 于 消费 者 可 能 非常 不 错 ， 但 对 于 电力 公司 
来 说 结果 可 能 就 不 那么 美妙 了 。 


监控 用 电量 是 一 个 很 重要 的 功能 ， 但 并 不 是 大 多 数 家 隆重 点 关注 的 问 
题 。 所 有 家 姓 实 际 上 所 关注 的 可 能 是 修 枉 草坪、 用 吸 侍 颖 清理 地 千 、 打 
扫 浴 室 等 事项 。 从 家 庭 的 角度 来 看 ， 监 控 房 屋 的 用 电量 是 一 个 被 动 事件 
(其 实 修 勇 草坪 也 是 一 个 被 动 事件 一 一 特别 是 在 炎热 的 天 气 下 )。 


软件 系统 中 的 一 些 功能 就 像 我 们 家 里 的 电表 一 样 。 这 些 功 能 需要 用 到 应 
用 程序 的 多 个 地 方 ， 但 是 我 们 又 不 想 在 每 个 点 都 明确 调用 它们 。 日 志 、 
安全 和 事务 管理 的 确 都 很 重要 ， 但 它们 是 否 为 应 用 对 象 主动 参与 的 行为 
呢 ? 如 果 让 应 用 对 象 只 关注 于 目 己 所 针对 的 业务 领域 问题 ， 而 其 他 方面 
的 问题 由 其 他 应 用 对 象 来 处 理 ， 这 会 不 会 更 好 呢 ? 


在 软件 开发 中 ， 散 布 于 应 用 中 多 处 的 功能 被 称 为 横 切 关注 点 (cross- 
cutting concern) 。 通 单 来 讲 ， 这 些 横 切 关注 点 从 概念 上 是 与 应 用 的 业务 


















































逻辑 相 分 离 的 《但 是 往往 会 直接 舱 入 到 应 用 的 业务 逻辑 之 中 ) 。 把 这 些 
横 切 关注 点 与 业务 馆 辑 相 分 离 正 是 面 癌 切面 编程 (AOP) 所 要 解决 的 问 


题 。 


在 第 2 章 ， 我 们 介绍 了 如 何 使 用 依赖 注入 (DI) 管理 和 配置 我 们 的 应 用 
对 象 。DI 有 助 于 应 用 对 象 之 间 的 解 厢 ， 而 AOP 可 以 实现 模 切 关注 点 与 它 
们 所 影响 的 对 象 之 间 的 解 粳 。 


志和 是 应 用 切面 的 冲 见 范例 ， 但 它 并 不 是 切面 适用 的 唯一 场景 。 通 览 
和 
季 。 


本 章 展示 了 Spring 对 切面 的 支持 ， 包 括 如 何 把 普通 类 声明 为 一 个 切面 和 
如 何 使 用 注解 创建 切面 。 除 此 之 外 ， 我 们 还 会 看 到 AspectJ 一 一 男 一 种 流 
行 的 AOP 实 现 如 何 补充 Spring AOP 框 架 的 功能 。 但 是 ， 我 们 先 不 管 
事务 、 安 全 和 缓存 ， 先 看 一 下 Spring 是 如 何 实现 切面 的 ， 就 从 AOP 的 基 
础 知识 开始 吧 。 














4.1 什么 是 面 癌 切面 编程 


如 前 所 述 ， 切 面 能 帮助 我 们 模块 化 模 切 关注 点 。 简 而 言 之 ， 横 切 天 注 点 
可 以 被 描述 为 影响 应 用 多 处 的 功能 。 例 如 ， 安 全 就 是 一 个 横 切 关注 点 ， 
应 用 中 的 许多 方法 都 会 涉及 到 安全 规则 。 图 4.1 直 观 呈 现 了 横 切 关注 点 
的 概念 。 
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图 4.1 切面 实现 了 横 切 关注 点 〈 跨 多 个 应 用 对 象 的 逻辑 ) 的 模块 化 


图 4.1 展 现 了 一 个 被 划分 为 模块 的 典型 应 用 。 每 个 模块 的 核心 功能 都 是 
为 特定 业务 领域 提供 服务 ， 但 是 这 些 模块 都 需要 类 似 的 辅助 功能 ， 例 如 
安全 和 事务 管理 。 


如 有 果 要 重用 通用 功能 的 话 ， 最 常见 的 面向 对 象 技术 是 继承 
Cinheritance) 或 委托 〈delegation) 。 但 是 ， 如 果 在 整个 应 用 中 都 使 用 
相同 的 基 类 ， 继 承 往往 会 导致 一 个 脆弱 的 对 象 体系 ; 而 使 用 委托 可 能 需 
要 对 委托 对 象 进行 复杂 的 调用 。 


切面 提供 了 取代 继承 和 委托 的 另 一 种 可 选 方案 ， 而 且 在 很 多 场景 下 更 清 
晰 简洁 。 在 使 用 面向 切面 编程 时 ， 我 们 仍然 在 一 个 地 方 定义 通用 功能 ， 
但 是 可 以 通过 声明 的 方式 定义 这 个 功能 要 以 何 种 方式 在 何 处 应 用 ， 而 无 
需 修 改 受 影响 的 类 。 横 切 关 注 点 可 以 被 模块 化 为 特殊 的 类 ， 这 些 类 被 称 
为 切面 (aspect〉。 这 样 做 有 两 个 好 处 首先 ， 现 在 每 个 关注 点 都 集中 
于 一 个 地 方 ， 而 不 是 分 散 到 多 处 代码 中 ;， 其 次 ， 服 务 模 块 更 简洁 ， 因 为 
它们 只 包含 主要 关注 点 (或 核心 功能 ) 的 代码 ， 而 次 要 关注 点 的 代码 被 
转移 到 切面 中 了 。 
































4.1.1 定义 AOP 术 语 


与 大 多 数 技 术 一 样 ，AOP 已 经 形成 了 自己 的 术语 。 摘 述 切 面 的 常用 术语 
有 通知 (advice〉、 切 点 〈pointcut) 和 连接 点 (join point) 。 图 4.2 展 示 
了 这 些 概念 是 如 何 关 联 在 一 起 的 。 






程序 执行 过 程 


连接 点 


图 4.2 ”在 一 个 或 多 个 连接 点 上 ， 
可 以 把 切面 的 功能 (通知 〉 织 入 到 程序 的 执行 过 程 中 
遗憾 的 是 ， 大 多 数 用 于 描述 AOP 功 能 的 术语 并 不 直观 ， 尽 管 如 此 ， 它 们 
现在 已 经 是 AOP 行 话 的 组 成 部 分 了 ， 为 了 理解 AOP， 我 们 必须 了 解 这 些 
术语 。 在 我 们 进入 某 个 领域 之 前 ， 必 须 学 会 在 这 个 领域 该 如 何 说 话 。 
通知 (Advice) 


当 抄 表 员 出 现在 我 们 家 门口 时 ， 他 们 要 登记 用 电量 并 回去 向 电力 公司 报 
告 。 显 然 ， 他 们 必须 有 一 份 需要 抄 表 的 住户 清单 ， 他 们 所 汇报 的 信息 也 
很 重要 ， 但 记录 用 电量 才 是 抄 表 员 的 主要 工作 。 


类 似 地 ， 切 面 也 有 目标 一 一 它 必 须要 完成 的 工作 。 在 AOP 术 语 中 ， 切 面 
的 工作 被 称 为 通知 。 


通知 定义 了 切面 是 什么 以 及 何 时 使 用 。 除 了 描述 切面 要 完成 的 工作 ， 通 
知 还 解决 了 何 时 执行 这 个 工作 的 问题 。 它 应 该 应 用 在 茶 个 方法 被 调用 之 
前 ? 之 后 ? 之 前 和 之 后 都 调用 ? 还 是 只 在 方法 抛 出 异常 时 调用 ? 

Spring 切面 可 以 应 用 5 种 类 型 的 通知 : 


。 六 置 通知 (Before) : 在 目标 方法 被 调用 之 前 调用 通知 功能 ; 























。 后 置 通知 (After) : 在 目标 方法 完成 之 后 调用 通知 ， 此 时 不 会 关心 
方法 的 输出 是 什么 ; 

返回 通知 〈After-returning) : 在 目标 方法 成 功 执 行 之 后 调用 通知 ; 
异常 通知 (After-throwing) : 在 目标 方法 抛 出 异常 后 调用 通知 ; 
环绕 通知 (Around) : 通知 包 里 了 被 通知 的 方法 ， 在 被 通知 的 方法 
调用 之 前 和 调用 之 后 执行 自 定义 的 行为 。 


连接 点 (Join point) 


电力 公司 为 多 个 住户 提供 服务 ， 甚 至 可 能 是 整个 城市 。 每 家 都 有 一 个 电 
表 ， 这 些 电表 上 的 数字 都 需要 读 取 ， 因 此 每 家 都 是 抄 表 员 的 潜在 目标 。 
抄 表 员 也 许 能 够 读 取 各 种 类 型 的 设备 ， 但 是 为 了 完成 他 的 工作 ， 他 的 目 
标 应 该 房屋 内 所 安装 的 电表 。 


同样 ， 我 们 的 应 用 可 能 也 有 数 以 千 计 的 时 机 应 用 通知 。 这 些 时 机 被 称 为 
连接 点 。 连 接点 是 在 应 用 执行 过 程 中 能 够 插入 切面 的 一 个 点 。 这 个 氮 可 
以 是 调用 方法 时 、 抛 出 异常 时 、 甚 至 修改 一 个 字段 时 。 切 面 代 码 可 以 利 
用 这 些 点 插入 到 应 用 的 正常 流程 之 中 ， 并 添加 新 的 行为 。 


切 点 (Poincut) 


如 琳 让 一 位 抄 表 员 访问 电力 公司 所 服务 的 所 有 住户 ， 那 肯定 是 不 现实 

的 。 实 际 上 ， 电 力 公司 为 每 一 个 抄 表 员 都 分 别 指定 某 一 块 区 域 的 住户 。 
类 似 地 ， 一 个 切面 并 不 需要 通知 应 用 的 所 有 连接 点 。 切 点 有 助 于 缩小 切 
面 所 通知 的 连接 点 的 范围 。 


如 果 说 通知 定义 了 切面 的 “什么 "和 “ 何 时 ”的 话 ， 那 么 切 点 就 定义 了 “ 僻 
处 "。 切 点 的 定义 会 匹配 通知 所 要 织 入 的 一 个 或 多 个 连接 点 。 我 们 通常 
使 用 明确 的 类 和 方法 名 称 ， 或 是 利用 正则 表达 式 定义 所 匹配 的 类 和 方法 
名 称 来 指定 这 些 切 点 。 有 些 AOP 框 架 多 许 我 们 创建 动态 的 切 点 ， 可 以 根 
据 运行 时 的 决策 (比如 方法 的 参数 值 》 来 决定 是 否 应 用 通知 。 


切面 (Aspect) 


当 抄 表 员 开始 一 天 的 工作 时 ， 他 知道 自己 要 做 的 事情 (报告 用 电量 〉 和 
从 哪些 房屋 收集 信息 。 因 此 ， 他 知道 要 完成 工作 所 需要 的 一 切 东西 。 


切面 是 通知 和 切 扣 的 结合 。 通 知 和 切 点 共同 定义 了 切面 的 全 部 内 容 一 一 























它 是 什么 ， 在 何 时 和 何 处 完成 其 功能 。 
引入 (Introduction) 


引入 允许 我 们 向 现 有 的 类 添加 新 方法 或 属性 。 例 如 ， 我 们 可 以 创建 一 
个 Auditable 通 知 类 ， 该 类 记录 了 对 象 最 后 一 次 修改 时 的 状态 。 这 很 简 
单 ， 只 需 一 个 方法 ，setLastModified(Date)， 和 一 个 实例 变量 来 保 
存 这 个 状态 。 然 后 ， 这 个 新 方法 和 实例 变量 就 可 以 被 引入 到 现 有 的 类 
el 以 在 无 需 修改 这 些 现 有 的 类 的 情况 下 ， 让 它们 具有 新 的 行为 
0 状态 。 

















织 入 (Weaving) 


织 入 是 把 切面 应 用 到 目标 对 象 并 创建 新 的 代理 对 象 的 过 程 。 切 面 在 指定 
0 目标 对 象 中 。 在 目标 对 象 的 生命 周期 里 有 多 个 点 可 以 
进行 织 入 : 


。 编译 期 : 切面 在 目标 类 编译 时 被 织 入 。 这 种 方式 需要 特殊 的 编译 
如 。AspectJ 的 织 入 编译 右 就 是 以 这 种 方式 织 入 切面 的 。 

。 类 加 载 期 : 切面 在 目标 类 加 载 到 JVM 时 被 织 入 。 这 种 方式 需要 特殊 
的 类 加 载 器 (ClassLoader) ， 它 可 以 在 目标 类 被 引入 应 用 之 前 增 
强 该 目标 类 的 字 节 码 。AspectJ 5 的 加 载 时 织 入 〈load-time 
weaving，LTW) 融 文 持 以 这 种 方式 织 入 切面 。 

。 运行 期 : 切面 在 应 用 运行 的 某 个 时 刻 被 织 入 。 一 般 情 况 下 ， 在 织 入 
切面 时 ，AOP 容 器 会 为 目标 对 象 动 态 地 创建 一 个 代理 对 象 。Spring 
AOP 就 是 以 这 种 方式 织 入 切面 的 。 


要 掌握 的 新 术语 可 真 不 少 啊 。 再 看 一 下 图 4.1， 现 在 我 们 已 经 了 解 了 如 
下 的 知识 ， 通 知 包含 了 需要 用 于 多 个 应 用 对 象 的 横 切 行为 ， 连 接点 是 程 
序 执行 过 程 中 能 够 应 用 通知 的 所 有 点 ; 切 点 定义 了 通知 被 应 用 的 具体 位 
ee 。 其 中 关键 的 概念 是 切 点 定义 了 哪些 连接 点 会 得 到 
通知 。 


我 们 已 经 了 解 了 一 些 基 础 的 AOP 术 语 ， 现 在 让 我 们 再 看 看 这 些 AOP 的 核 
心 概 念 是 如 何在 Spring 中 实现 的 。 


























4.1.2 ”Spring 对 AOP 的 支持 





并 不 是 所 有 的 AOP 框 染 都 是 相同 的 ， 它 们 在 连接 点 模型 上 可 能 有 强 弱 之 
分 。 有 些 允 许 在 字段 修饰 符 级 别 应 用 通知 ， 而 为 一 些 只 支持 与 方法 调用 
相关 的 连接 点 。 它 们 织 入 切面 的 方式 和 时 机 也 有 所 不 同 。 但 是 无 论 如 
何 ， 创 建 切 点 来 定义 切面 所 织 入 的 连接 点 是 AOP 框 染 的 基本 功能 。 


因为 这 是 一 本 介绍 Spring 的 图 书 ， 所 以 我 们 会 关注 Spring AOP。 虽 然 如 
此 ，Spring 和 AspectJ 项 目 之 间 有 大 量 的 协作 ， 而 且 Spring 对 AOP 的 文 持 
在 很 多 方面 借鉴 了 AspectJ 项 目 。 


Spring 提 供 了 4 种 类 型 的 AOP 支 持 : 


。 基于 代理 的 经 典 Spring AOP; 

。 纯 POJO 切 面 ; 

。 @Aspect]J 注 解 驱动 的 切面 ; 

。 注入 式 AspectJ 切 面 〈 适 用 于 Spring 各 版 本 ) 。 


前 三 种 都 是 Spring AOP 实 现 的 变 体 ，Spring AOP 构 建 在 动态 代理 基础 之 
上 ， 因 此 ，Spring 对 AOP 的 支持 局 限于 方法 拦截 。 


术语 “经 典 ” 通 常 意味 着 是 很 好 的 东西 。 老 和 爷 车 、 经 典 高 尔 夫 球赛 、 可 口 
可 乐 精品 都 是 好 东西 。 但 是 Spring 的 经 典 AOP 编 程 模型 并 不 怎么 样 。 当 
然 ， 曾 经 它 的 确 非常 棒 。 但 是 现在 Spring 提 供 了 更 简洁 和 干净 的 面向 切 
面 编程 方式 。 引 入 了 简单 的 声明 式 AOP 和 基于 注解 的 AOP 之 后 ，Spring 
经 典 的 AOP 看 起 来 就 显得 非常 笨重 和 过 于 复杂 ， 直 接 使 用 ProxyFactory 
Bean 会 让 人 感觉 大 烦 。 所 以 在 本 书 中 我 不 会 再 介绍 经 典 的 Spring AOP。 


借助 Spring 的 aop 命 名 空间 ， 我 们 可 以 将 纯 POJO 转 换 为 切面 。 实 际 上 ， 

这 些 POJO 只 是 提供 了 满足 切 点 条 件 时 所 要 调用 的 方法 。 遗 憾 的 是 ， 这 
种 技术 需要 XML 配置 ， 但 这 的 确 是 声明 式 地 将 对 象 转换 为 切面 的 简便 

Spring 借鉴 了 Aspect 的 切面 ， 以 提供 注解 驱动 的 AOP。 本 质 上 ， 它 依然 
是 Spring 基于 代理 的 AOP， 但 是 编程 模型 几乎 与 编写 成 熟 的 AspectJ 注 解 
切面 完全 一 致 。 这 种 AOP 风 格 的 好 处 在 于 能 够 不 使 用 XML 来 完成 功 


全 已 
月 5。 


如 果 你 的 AOP 需 求 超过 了 简单 的 方法 调用 《如 构造 器 或 属性 拦截 ) ， 那 
么 你 需要 考虑 使 用 AspectJ 来 实现 切面 。 在 这 种 情况 下 ， 上 文 所 示 的 第 四 




















种 类 型 能 够 帮助 你 将 值 注 入 到 AspectJ 驱 动 的 切面 中 。 


我 们 在 将 本 本 昔 展 示 更 多 外 Spring AOP 技 术 ， 但 是 在 开始 之 前 ， 我 们 必 
须要 了 解 Spring AOP 框 架 的 一 些 关 键 知识 。 


Spring 通知 是 Java 编 写 的 


Spring 所 创建 的 通知 都 是 用 标准 的 Java 类 编写 的 。 这 样 的 话 ， 我 们 就 可 
以 使 用 与 普通 Java 开 发 一 样 的 集成 开发 环境 (IDE) 来 开发 切面 。 而 
目 。 定义 通知 所 应 用 的 切 点 通常 会 使 用 注解 或 在 Spring 配置 文件 里 采用 
XML 来 编写 ， 这 两 种 语法 对 于 Java 开 发 者 来 说 都 是 相当 熟悉 的 。 


Aspectj 与 之 相反 。 虽 然 AspectJ 现 在 支持 基于 注解 的 切面 ， 但 AspectJ 最 
初 是 以 Java 语 言 扩 展 的 方式 实现 的 。 这 种 方式 有 优点 也 有 人 缺点。 通过 特 
有 的 AOP 语 言 ， 我 们 可 以 获得 更 强大 和 细 粒 度 的 控制 ， 以 及 更 丰富 的 
AOP 工 具 集 ， 但 是 我 们 需要 额外 学 习 新 的 工具 和 语法 。 


Spring 在 运行 时 通知 对 象 


过 在 代理 类 中 包 右 切面 ，Spring 在 运行 期 把 切面 织 入 到 Spring 管理 的 
， 如 图 4.3 所 示 ， 代 理 类 封装 了 目标 类 ， 并 拦截 被 通知 方法 的 调 
用 ， 再 把 调用 转发 给 真正 的 目标 bean。 当代 理 拦截 到 方法 调用 时 ， 在 调 
用 目标 bean 方 法 之 前 ， 会 执行 切面 逻辑 。 





























图 4.3 ”Spring 的 切面 由 包 右 了 目标 对 象 的 代理 类 实现 。 
代理 类 处 理 方法 的 调用 ， 执 行 额外 的 切面 逻辑 ， 并 调用 目标 方法 


直到 应 用 需要 被 代理 的 bean 时 ，Spring 才 创建 代理 对 象 。 如 果 使 用 的 
是 ApplicationContext 的 话 ， 在 ApplicationContext 从 



























































BeanFactory 中 加 载 所 有 bean 的 时 候 ，Spring 才 会 创建 被 代理 的 对 象 。 
因为 Spring 运 行 时 才 创 建 代理 对 象 ， 所 以 我 们 不 需要 特殊 的 编译 器 来 织 
入 Spring AOP 的 切面 。 


Spring 只 文 持 方法 级 别 的 连接 点 


正如 前 面 所 探讨 过 的 ， 通 过 使 用 各 种 AOP 方 案 可 以 文 持 多 种 连接 点 模 

型 。 因 为 Spring 基于 动态 代理 ， 所 以 Spring 只 文 持 方 法 连接 点 。 这 与 一 

些 其 他 的 AOP 框 架 是 不 同 的 ， 例 如 AspectJ 和 JBoss， 除 了 方法 切 点 ， 它 
们 还 提供 了 字段 和 构造 器 接 入 点 。Spring 人 缺少 对 字段 连接 点 的 支持， 无 
法 让 我 们 创建 细 料 度 的 通知 ， 例 如 拦截 对 象 字段 的 修改 。 而 且 它 不 文 持 
构造 器 连接 点 ， 我 们 就 无 法 在 bean 创 建 时 应 用 通知 。 


但 是 方法 拦截 可 以 满足 绝 大 部 分 的 需求 。 如 果 需 要 方法 拦截 之 外 的 连接 
点 拦截 功能 ， 那 么 我 们 可 以 利用 Aspect 来 补充 Spring AOP 的 功能 
对 于 什么 是 AOP 以 及 Spring 如 何 支 持 AOP 的 ， 我 们 现在 已 经 有 了 一 个 大 


致 的 了 解 。 现 在 是 时 候 学 习 如 何在 Spring 中 创建 切面 了 ， 让 我 们 先 从 
Spring 的 声明 式 AOP 模 型 开始 。 








4.2 ”通过 切 扣 来 选择 连接 点 


正如 之 前 所 提 过 的 ， 切 点 用 于 准确 定位 应 该 在 什么 地 方 应 用 切面 的 通 
知 。 通 知 和 切 点 是 切面 的 最 基本 元 素 。 因 此 ， 了 解 如 何 编写 切 点 非常 重 


要 。 


在 Spring AOP 中 ， 要 使 用 AspectJ 的 切 点 表达 式 语言 来 定义 切 点 。 如 果 你 
己 经 很 熟悉 AspectJ， 那 么 在 Spring 中 定义 切 点 就 感谢 非常 自然 。 但 是 如 

果 你 一 点 都 不 了 解 AspectJ 的 话 ， 本 小 节 我 们 将 快速 介绍 一 下 如 何 编写 

AspectJ 风 格 的 切 点 。 如 果 你 想 进 一 步 了 解 AspectJ 和 AspectJ 切 点 表达 式 

语言 ， 我 强烈 推荐 Ramniva Laddad 编 写 的 《AspectJ in Action》 第 二 版 
(Manning, 2009, www.manning.com/laddad2/) 。 





关于 Spring AOP 的 AspectJ 切 点 ， 最 重要 的 一 点 束 是 Spring 仪 文 持 AspectJ 
切 点 指示 器 (pointcut designator) 的 一 个 子 集 。 让 我 们 回顾 下 ，Spring 
是 基于 代理 的 ， 而 某 些 切 点 表达 式 是 与 基于 代理 的 AOP 无 关 的 。 表 4.1 
列 出 了 Spring AOP 所 支持 的 AspectJ 切 反 指 示 絮 。 


表 4.1 Spring 借助 AspectJ 的 切 点 表达 式 语 言 来 定义 Spring 切面 

















AspectJ 指 
示 器 





制 连接 点 匹配 参数 为 指定 类 型 的 执行 方法 

判 连接 点 匹配 参数 由 指定 注解 标注 的 执行 方法 
关连 接点 匹配 AOP 代 理 的 bean 引 用 为 指定 类 型 的 类 
制 连接 点 匹配 目标 对 象 为 指定 类 型 的 类 


限制 连接 点 匹配 特定 的 执行 对 象 ， 这 些 对 象 对 应 的 类 要 具有 指定 类 型 的 





























起 
Ud 


@target() 


限制 连接 点 匹配 指定 的 类 型 


限制 连接 点 匹配 指定 注解 所 标注 的 类 型 〈 当 使 用 Spring AOP 时 ， 方 法 定 








0 | 文 在 由 指定 的 注解 所 标注 的 类 里 ) 


限定 匹配 带 有 指定 注解 的 连接 点 


在 Spring 中 党 试 使 用 AspectJ 其 他 指示 器 时 ， 将 会 抛 出 
IllegalArgument-Exception 异 常 。 


当 我 们 查看 如 上 所 展示 的 这 些 Spring 支持 的 指示 器 时 ， 注意 只 

有 execution 指 示 器 # 是 实际 执行 匹配 的 ， 而 其 他 的 指示 右 都 是 用 来 限制 
匹配 的 。 这 说 明 execution 指 示 器 是 我 们 在 编写 切 点 定义 时 最 主要 使 用 
的 指示 器 。 在 此 基础 上 ， 我 们 使 用 其 他 指示 器 来 限制 所 匹配 的 切 点 。 




















4.2.1 ”编写 切 点 


为 了 阐述 Spring 中 的 切面 ， 我 们 需要 有 个 主题 来 定义 切面 的 切 点 。 为 
此 ， 我 们 定义 一 个 Performance 接 口 : 


package concert 


public interface Performance { 
public void perform(); 


} 





Performance 可 以 代表 任何 类 型 的 现场 表演 ， 如 舞台 剧 、 电 影 或 音乐 
会 。 I nn 图 
4.4 展 现 了 一 个 切 点 表达 式 ， 这 个 表达 式 能 够 设置 当 perform() 方 法 执行 时 
触发 通知 的 调用 。 


返回 任意 类 型 。” 方法 所 属 的 类 方法 。 使用 任意 参数 





[1 II FE 本 
execution(* concert .Performance .Perform( ..)) 
| || | 





在 方法 执行 时 触发 指定 方法 




















图 4.4 ”使 用 AspectJ 切 点 表达 式 来 选择 Performance 的 perform() 方 法 


我 们 使 用 execution( ) 指 示 器 选择 Performance 的 perform() 方 法 。 方 

法 表达 式 以 “#*?” 号 开始 ， 表 明了 我 们 不 关心 方法 返回 值 的 类 型 。 然 后 ， 

我 们 指定 了 全 限定 类 名 和 方法 名 。 对 于 方法 参数 列表 ， 我 们 使 用 两 个 点 

(..) 表明 切 点 要 选择 任意 的 perform() 方 法 ， 无 论 该 方法 的 入 参 是 
么 。 


现在 假设 我 们 需要 配置 的 切 点 仅 匹 配 concert 包 。 在 此 场景 下 ， 可 以 使 
用 within() 指 示 器 来 限制 匹配 ， 如 网 4.5 所 示 。 


执行 Performance.perform() 方 法 














| | 
execution(* concert.Performance.perform(..)) 
&& within(concert.*)) 


与 (and) 操 作 当 concert 包 下 的 任意 类 的 方法 被 调用 时 








图 4.5 “使 用 within0 指 示 器 限制 切 点 范围 


请 注意 我 们 使 用 了 “&&" 操 作 符 把 execution() 和 within() 指 示 器 连接 
在 一 起 形成 与 and) 关系 〈 切 点 必须 匹配 所 有 的 指示 器 ) 。 类 似 地 ， 

我 们 可 以 使 用 “| | ?操作 符 来 标识 或 (or) 关系 ， 而 使 用 “1” 操 作 符 来 标 
识 非 (not) 操作 。 


因为 “&" 在 XML 中 有 特殊 含义 ， 所 以 在 Spring 的 XML 配置 里 面 描述 切 点 
时 ， 我 们 可 以 使 用 and 来 代替 “&&”。 同 样 ，or 和 not 可 以 分 别 用 来 代 
蔡 “ | | 2 和 “ | 2 。 

4.2.2 ”在 切 点 中 选择 bean 


除了 表 4.1 所 列 的 指示 器 外 ，Spring 还 引入 了 一 个 新 的 bean() 指 示 器 ， 
它 人 允许 我 们 在 切 点 表达 式 中 使 用 bean 的 ID 来 标识 bean。bean() 使 用 bean 


ID 或 bean 名 称 作为 参数 来 限制 切 点 只 匹配 特定 的 bean。 
例如 ， 考 虑 如 下 的 切 点 : 


execution(* concert .Performance .perform( ) ) 

and bean('woodstock') 
在 这 里 ， 我 们 希望 在 执行 Performance 的 perform() 方 法 时 应 用 通知 ， 
但 限定 bean 的 ID 为 woodstock。 


在 某 些 场景 下 ， 限 定 切 点 为 指定 的 bean 或 许 很 有 意义 ， 但 我 们 还 可 以 使 
用 非 操 作为 除了 特定 ID 以 外 的 其 他 bean 应 用 通知 : 


execution(* concert .Performance .perform( ) ) 
and lbean('woodstock') 
在 此 场景 下 ， 切 面 的 通知 会 被 编织 到 所 有 ID 不 为 woodstock 的 bean 中 。 


现在 ， 我 们 已 经 讲解 了 编写 切 点 的 基础 知识 ， 让 我 们 再 了 解 一 下 如 何 编 
写 通 知 和 使 用 这 些 切 点 声明 切面 。 








4.3 ”使 用 注解 创建 切面 

使 用 注解 来 创建 切面 是 AspectJ 5 所 引入 的 关键 特性 。AspectJ 5 之 前 ， 编 
写 AspectJ 切 面 需要 学 习 一 种 Java 语 言 的 扩展 ， 但 是 AspectJ 面 问 注 解 的 模 
型 可 以 非常 简便 地 通过 少量 注解 把 任意 类 转变 为 切面 。 


我 们 已 经 定义 了 Performance 接 口 ， 它 是 切面 中 切 点 的 目标 对 象 。 现 
在 ， 让 我 们 使 用 AspecJ 注 解 来 定义 切面 。 

4.3.1 定义 切面 

如 果 一 场 演出 没有 观众 的 话 ， 那 不 能 称 之 为 演出 。 对 不 对 ? 从 演出 的 角 
度 来 看 ， 观 众 是 非常 重要 的 ， 但 是 对 演出 本 身 的 功能 来 讲 ， 它 并 不 是 核 
心 ， 这 是 一 个 单独 的 关注 上 点。 因此， 将 观众 定义 为 一 个 切面 ， 并 将 其 应 
用 到 演出 上 就 是 较为 明智 的 做 法 。 

程序 清单 4.1 展 现 了 Audience 类 ， 它 定义 了 我 们 所 需 的 一 个 切面 。 
程序 清单 4.1 Audience 类 : 观看 演出 的 切面 


package concert; 
import org.aspectj.lang.annotation.AfterReturning; 
import org.aspectij.lang.annotation.AfterThrowing; 
import org.aspectj.lang.annotation.a 

r r 


\spect; 
import org.aspectj.lang.annotation.Before; 


@Aspect 
public class Audience { 表演 之 前 


@BRefore("execution(** concert.Performance.perform(..))") 
public void silenceCellPhones{) { 


System.out .println("Silencing cell phones"); 


} ca 全 
表演 之 前 
@Before("execution{** concert. Performance.perform(..))") 
public void takeSeats() { 
System.out .printin("Taking seats"); 
} 
ng ("execution(** concert.Performance.perform{..))") 
public void applause() 
SLAP < 表演 之 后 
System.out .println("CLAP CLAP CLAP!!!"); HO/ 
} 
J 
@AfterThrowing ("execution(** concert.Performance.perform(..)}))") 
public void demandRefund() { 
> E K Tt Ne 月 -也 4 一 
System.out .println("Demanding a refund"); 表演 失败 之 后 
J 


Audience 类 使 用 @Aspect]J 注 解 进行 了 标注 。 该 注解 表明 Audience 不 仪 
仅 是 一 个 POJO， 还 是 一 个 切面 。Audience 类 中 的 方法 都 使 用 注解 来 定 
义 切面 的 具体 行为 。 


Audience 有 四 个 方法 ， 定 义 了 一 个 观众 在 观看 演出 时 可 能 会 做 的 事 
情 。 在 演出 之 前 ， 观 众 要 就 坐 (takeSeats()) 并 将 手机 调 至 静音 状态 
(silenceCellPhones()) 。 如 果 演 出 很 精彩 的 话 ， J 鼓掌 
喝彩 (applause()) 。 不 过 ， 如 果 演 出 没有 达到 观众 预期 的 话 ， 观 众 
会 要 求 退 款 (demandRefund() ) 。 


可 以 看 到 ， 这 些 方法 都 使 用 了 通知 注解 来 表明 它们 应 该 在 什么 时 候 调 
用 。Aspect 提 供 了 五 个 注解 来 定义 通知 ， 如 表 4.2 所 示 。 


表 4.2 ”Spring 使 用 AspectJ 注 解 来 声明 通知 方法 








通知 方法 会 在 目标 方法 返回 或 抛 出 异常 后 调 月 














@AfterReturning 通知 方法 会 在 目标 方法 返回 后 调用 





@AfterThrowing 通知 方法 会 在 目标 方法 抛 出 异常 后 调用 





通知 方法 会 将 目标 方法 封装 起 来 





通知 方法 会 在 目标 方法 调用 之 前 执行 








Audience 使 用 到 了 前 面 五 个 注解 中 的 三 个 。takeSeats() 和 silence 
CellPhones() 方 法 都 用 到 了 Q@Before 注 解 ， 表 明 它 们 应 该 在 演出 开始 
之 前 调用 。applause() 方 法 使 用 了 @AfterReturning 注 解 ， 它 会 在 演 
出 成 功 返 回 后 调用 。demandRefund() 方 法 上 添加 了 @AfterThrowing 
注解 ， 这 表明 它 会 在 抛 出 异常 以 后 执行 。 


你 可 能 已 经 注意 到 了 ， 所 有 的 这 些 注解 都 给 定 了 一 个 切 点 表达 式 作 为 它 
的 值 ， 同 时 ， 这 四 个 方法 的 切 点 表达 式 都 是 相同 的 。 其 实 ， 它 们 可 以 设 
置 成 不 同 的 切 点 表达 式 ， 但 是 在 这 里 ， 这 个 切 点 表达 式 就 能 满足 所 有 通 
知 方法 的 需求 。 让 我 们 近 距 离 看 一 下 这 个 设置 给 通知 注解 的 切 点 表达 
式 ， 我 们 发 现 它 会 在 Performance 的 perform( ) 方 法 执行 时 触发 。 
相同 的 切 点 表达 式 我 们 重复 了 四 裔 ， 这 可 真 不 是 什么 光彩 的 事情 。 这 样 


的 重复 让 人 感觉 有 些 不 对 劲 。 如 果 我 们 只 定义 这 个 切 点 一 次 ， 然 后 每 次 
需要 的 时 候 引 用 它 ， 那 么 这 会 是 一 个 很 好 的 方案 。 

幸好 ， 我 们 完全 可 以 这 样 做 : @Pointcut 注 解 能 够 在 一 个 OAspect] 切 

面 内 定义 可 重用 的 切 点 。 接 下 来 的 程序 清单 4.2 展 现 了 新 的 Audience， 

现在 它 使 用 了 @Pointcut。 


程序 清单 4.2 通过 @Pointcut 注 解 声 明 频 繁 使 用 的 切 点 表达 式 











otation.AfterReturning; 





rowing; 






1 

i ct; 
tj.lang.annotation.Before; 

1 


ectj.lang.annotation.Point 


定义 命名 
的 切 点 
@Pointcut ("execution(** concert.Performance.perform{..))") 
public void performancet) 


&@Beforel"performance!(})") 


















public void silenceCellPhones() { 
5 9 ee 

System.out .printlin("Silencing cell phones"); 表演 之 前 
} 
@Be > ("performance!l)}") 
Pu void takeSeats() { 

sm.out .println("Taking seats"); 

} 
} 
@AE Returning{ "performance!()") 表演 之 后 
public void applausel() { 

System.out.println("CLAP CLAP CLAP!!!"); 


表演 失败 之 后 





在 Audience 中 ，performance() 方 法 使 用 了 @Pointcut 注 解 。 

为 @Pointcut 注 解 设置 的 值 是 一 个 切 点 表达 式 ， 就 像 之 前 在 通知 注解 上 
所 设置 的 那样 。 通 过 在 performance() 方 法 上 添加 @pointcut 注 解 ， 我 
们 实际 上 扩展 了 切 点 表达 式 语言 ， 这 样 就 可 以 在 任何 的 切 点 表达 式 中 使 
用 performance() 了， 如 果 不 这 样 做 的 话 ， 你 需要 在 这 些 地 方 使 用 那个 
更 长 的 切 点 表达 式 。 我 们 现在 把 所 有 通知 注解 中 的 长 表达 式 都 蔡 换 成 了 


performance( ) 。 


performance() 方 法 的 实际 内 容 并 不 重要 ， 在 这 里 它 实际 上 应 该 是 空 
的 。 其 实 该 方法 本 和 刁 只 是 一 个 标识 ， 供 @Pointcut 注 解 依附 。 








需要 注意 的 是 ， 除 了 注解 和 没有 实际 操作 的 performance() 方 

法 ，Audience 类 依然 是 一 个 POJO。 我 们 能 够 像 使 用 其 他 的 Java 类 那样 

调用 它 的 方法 ， 它 的 方法 也 能 够 独立 地 进行 单元 测试 ， 这 与 其 他 的 Java 
类 并 没有 什么 区 别 。Audience 只 是 一 个 Java 类 ， 只 不 过 它 通过 注解 表明 
会 作为 切面 使 用 而 已 。 


像 其 他 的 Java 类 一 样 ， 它 可 以 装配 为 Spring 中 的 bean: 


@Bean 
public Audience audience() { 
return new Audience(); 


} 





如 果 你 就 此 止步 的 话 ，Audience 只 会 是 Spring 容 器 中 的 一 个 bean。 即 便 
使 用 了 AspectJ 注 解 ， 但 它 并 不 会 被 视 为 切面 ， 这 些 注解 不 会 解析 ， 也 不 
会 创建 将 其 转换 为 切面 的 代理 。 


如 果 你 使 用 JavaConfig 的 话 ， 可 以 在 配置 类 的 类 级 别 上 通过 使 
用 EnableAspectJ-AutoProxy 注 解 启用 上 自动 代理 功能 。 程 序 清单 4.3 展 
现 了 如 何在 JavaConfig 中 启用 自动 代理 。 


程序 清单 4.3 ”在 JavaConfig 中 启用 AspectJ 注 解 的 自动 代理 


package concert; 
import org.springframework.context .annotation.Bean; 
import org.springframework.context.annotation.ComponentSscan; 
import org.springframework.context .annotation.Configuration; 
import org.springframework.context .annotation.EnableAspectJAutoProxy; 
@Configuration 
@EnableAspectJAutoProxy 、 ET 
本 启用 Aspect 自动 代理 
@Componentscan 
public class ConcertConfig { 
GBean 
iblic Audience diencel 。 
public Audience ou ence() { 声明 Audience bean 
return new Audience(); 


} 


1 
J 


假如 你 在 Spring 中 要 使 用 XML 来 装配 bean 的 话 ， 那 么 需要 使 用 Spring 
aop 命 名 空间 中 的 <aop:aspectj-autoproxy> 元 素 。 下 面 的 XML 配置 
展现 了 如 何 完 成 该 功能 。 


程序 清单 4.4 在 XML 中 ， 通 过 Spring 的 aop 命 名 空间 启用 AspectJ 自 动 
代理 


声明 
:context" Spring 的 

aop 命名 
空间 





| rk.org/schema/aop 
全 全 ing~aop.xsd 


” ork.org/schema/context/spring-context .xsd"> 
3 

启用 
AspectU <Context:comonent-scan pase-package="concert" /> 


自动 代理 


声明 Audience bean 


不 管 你 是 使 用 JavaConfig 还 是 XML，AspectU 自 动 代理 都 会 为 使 
用 @Aspect 注 解 的 bean 创 建 一 个 代理 ， 这 个 代理 会 围绕 着 所 有 该 切面 的 
切 点 所 匹配 的 bean。 在 这 种 情况 下 ， 将 会 为 Concertbean 创 建 一 个 代 
理 ，Audience 类 中 的 通知 方法 将 会 在 perform( ) 调 用 前 后 执行 。 


我 们 需要 记 住 的 是 ， Spring 的 AspectJ 晶 动 代理 仅 仪 使 用 @AspectJ 作 为 
创建 切面 的 指导 ， 切 面 依然 是 基于 代理 的 。 在 本 质 上 ， 它 依然 是 Spring 
基于 代理 的 切面 。 这 一 点 非常 重要 ， 因 为 这 意味 着 尽管 使 用 的 

是 @AspectJ 注 解 ， 但 我 们 仍然 限于 代理 方法 的 调用 。 如 采 想 利用 
AspectJ 的 所 有 能 力 ， 我 们 必须 在 运行 时 使 用 AspectJ 并 且 不 依赖 Spring 来 
创建 基于 代理 的 切面 。 


到 现在 为 止 ， 我 们 的 切面 在 定义 时 ， 使 用 了 不 同 的 通知 方法 来 实现 前 置 
通知 和 后 置 通知 。 但 是 表 4.2 还 提 到 了 男 外 的 一 种 通知 : 环绕 通知 
(around advice) 。 环 绕 通 知 与 其 他 类 型 的 通知 有 所 不 同 ， 因 此 值得 花 
点 时 间 来 介绍 如 何 进行 编写 。 


4.3.2 ”创建 环绕 通知 

环绕 通知 是 最 为 强大 的 通知 类 型 。 它 能 够 让 你 所 编写 的 逻辑 将 被 通知 的 
ee 一 个 通知 方法 中 同时 编写 前 置 通 
0 和 1 


绕 通 知 ， 我 们 重 写 Audience 切 面 。 这 次 ， 我 们 使 用 一 个 环 
通知 来 代替 之 前 多 个 不 同 的 前 置 通 知 和 后 置 通知 。 

















程序 清单 4.5 ”使 用 环绕 通知 重新 实现 Audience 切 面 


‘ance .perform(..))") 定 义 命名 
的 切 点 





在 这 里 ，Q@Around 注 解 表明 watchPerformance() 方 法 会 作 

为 performance() 切 点 的 环绕 通知 。 在 这 个 通知 中 ， 观 众 在 演出 之 前 会 
将 手机 调 至 静音 并 束 坐 ， 演 出 结束 后 会 豆 掌 喝彩 。 像 前 面 一 样 ， 如 果 演 
出 失败 的 话 ， 观 众 会 要 求 退 球 。 


可 以 看 到 ， 这 个 通知 所 达到 的 效果 与 之 前 的 前 置 通知 和 后 置 通知 是 一 样 
的 。 但 是 ， 现 在 它们 位 于 同一 个 方法 中 ， 不 像 之 前 那样 分 散在 四 个 不 同 
的 通知 方法 里 面 。 


关于 这 个 新 的 通知 方法 ， 你 首先 注意 到 的 可 能 是 它 接 受 
ProceedingJoinPoint 作 为 参数 。 这 个 对 象 是 必须 要 有 的 ， 因 为 你 要 
在 通知 中 通过 它 来 调用 被 通知 的 方法 。 通 知 方法 中 可 以 做 任何 的 事情 ， 
当 要 将 控制 权 交 给 被 通知 的 方法 时 ， 它 需要 调 

用 ProceedingJoinPoint 的 proceed() 方 法 。 


需要 注意 的 是 ， 别 忘记 调用 proceed() 方 法 。 如 果 不 调 这 个 方法 的 话 ， 
那么 你 的 通知 实际 上 会 阻塞 对 被 通知 方法 的 调用 。 有 可 能 这 就 是 你 想 要 
的 效果 ， 但 更 多 的 情况 是 你 希望 在 某 个 点 上 执行 被 通知 的 方法 。 


有 意思 的 是 ， 你 可 以 不 ee 从 而 阻塞 对 被 通知 方法 的 
访问 ， 与 之 类 似 ， 你 也 可 以 在 通知 中 对 它 进 行 多 次 调用 。 要 这 样 做 的 一 














个 场景 就 是 实现 重 斌 逻辑 ， 也 惑 是 在 被 通知 方法 失败 后 ， 进 行 重复 答 
试 。 


4.3.3 ”处 理 通 知 中 的 参数 


到 目前 为 止 ， 我 们 的 切面 都 很 简单 ， 没 有 任何 参数 。 唯 一 的 例外 是 我 们 
为 环绕 通知 所 编写 的 watchPerformance( ) 示 例 方 法 中 使 用 了 
ProceedingJoinPoint 作 为 参数 。 除 了 环绕 通知 ， 我 们 编写 的 其 他 通 
知 不 需要 关注 传递 给 被 通知 方法 的 任意 参数 。 这 很 正常 ， 因 为 我 们 所 通 
知 的 perform() 方 法 本 里 没有 任何 参数 。 


但 是 ， 如 果 切 面 押 通知 的 方法 确实 有 参数 该 怎么 办 呢 ? 切面 能 访问 和 使 
用 传递 给 被 通知 方法 的 参数 吗 ? 


为 了 阐述 这 个 问题 ， 让 我 们 重新 看 一 下 2.4.4 小 市 中 的 BlankDisc 样 
例 。play() 方 法 会 循环 所 有 的 磁道 并 调用 playTrack() 方 法 。 但 是 ， 
我 们 也 可 以 通过 playTrack() 方 法 直接 播放 某 一 个 人 磁道 中 的 歌曲 。 


假设 你 想 记录 每 个 人 磁道 被 播放 的 次 数 。 一 种 方法 就 是 修改 playTrack() 
方法 ， 直 接 在 每 次 调用 的 时 候 记 录 这 个 数量 。 但 是 ， 记 录 磁 道 的 播放 次 
数 与 播放 本 和 刁 是 不 同 的 关注 点 ， 因 此 不 应 该 属于 playTrack() 方 法 。 看 
起 来 ， 这 应 该 是 切面 要 完成 的 任务 。 


为 了 记录 每 个 磁道 所 播放 的 次 数 ， 我 们 创建 了 TrackCounter 类 ， 它 是 
通知 playTrack() 方 法 的 一 个 切面 。 下 面 的 程序 清单 展示 了 这 个 切面 。 


程序 清单 4.6 使 用 参数 化 的 通知 来 记录 磁道 播放 的 次 数 

















package soundsystem; 

import java.util.HashMap; 

import java,util .Map; 

import org.aspectij.lang.annotation.Aspect; 
import org.aspectj.lang.annotation.Before; 
import org.aspectj.lang.annotation.Pointcut; 


Q&Aspect 
public class TrackCounter { 


private Map<Integer, Integer> trackCounts = 
new HashMap<Integer, Integer>(); 


通知 play- 
@Pointcut( Track() 方 法 
"execution(* soundsystem.CompactDisc.playTrack(int)) " + 
"&&k args (trackNumber}") 
public void trackPlayed(int trackNumber) {} 


@Before("trackPlayed (ltrackNumber)") 在 播放 前 ， 为 该 磁道 
public void countTrack(lint trackNumber) { 计数 
int currentCount = getPlayCount (trackNumber); 
trackCounts.put{ltrackNumber, currentCount + 1); 
} 


public int getPlayCount (int trackNumber) { 
return trackCounts.containsKey (trackNumber) 
? trackCounts.get (trackNumber) : 0; 
} 


下 
} 


po A 样 ， a 名 的 切 
人 nn ee 前 知 。 但 是 ， 这 里 的 不 同 点 
在 于 切 点 还 声明 了 要 提供 给 通知 方法 的 参数 。 图 4.6 将 切 点 表达 式 进行 
了 分 解 ， 以 展现 参数 是 在 什么 地 方 指定 的 。 


ea 
返回 任意 类 型 。 方法 所 属 的 类 型 pi 
LL | | 全 隔 本 | 
execution(* soundsystem.CompactDisc.playTrack (int)) 
&& args (trackNumber) 
| | 








指定 参数 





图 4.6 在 切 点 表达 式 中 声明 参数 ， 这 个 参数 传 入 到 通知 方法 中 


在 图 4.6 中 需要 关注 的 是 切 点 er A Oo 
它 表 明 传 递 给 playTrack() 方 法 的 int 类 型 参数 也 会 传递 到 通知 中 去 。 
参数 的 名 称 trackNumber 也 与 切 点 方法 签名 中 的 参数 相 匹 配 。 


这 个 参数 会 传递 到 通知 方法 中 ， 这 个 通知 方法 是 通过 @Before 注 解 和 命 
名 切 点 trackPlayed(trackNumber) 定 义 的 。 切 点 定义 中 的 参数 与 切 点 








方法 中 的 参数 名 称 是 一 样 的 ， 这 样 束 完成 了 从 命名 切 点 到 通知 方法 的 参 
数 转移 。 


现在 ， 我 们 可 以 在 Spring 配置 中 将 BlankDisc 和 TrackCounter 定 义 为 
bean， 并 局 用 AspectJ 上 自动 代理 ， 如 程序 清单 4.7 所 示 。 


程序 清单 4.7 配置 TrackCount 记 录 每 个 磁道 播放 的 次 数 


package soundsystem; 

import java.util.ArrayList; 

import java.util .List; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.context.annotation.EnableAspectJAutoProxy; 


@Configuration 
@EnableAspectJAutoProxy 4 启用 Aspect] 自动 代理 


public class TrackCounterConfig { 


@Bean 

public CompactDisc sgtPeppers() { < CompactDisc bean 
BlankDisc cd = new BlankDisct{); 
cd.setTitle("Sgt,. Pepper's Lonely Hearts Club Band"); 
cd.setArtist ("The Beatles"); 
List<String> tracks = new ArrayList<String>(); 
tracks.add("sgt. Pepper's Lonely Hearts Club Band"); 
tracks.add("With a Littile Help from My Friends"); 
tracks.add("Lucy in the Sky with Diamonds"); 
tracks.add("'Getting Better"); 
tracks.add("Fixing a Hole"); 


一 


// ...other tracks omitted for brevity... 
cd.setTracks (tracks); 
return cd; 

} 


@Bean 
public TrackCounter trackCounter{() { < TrackCounter bean 
return new TrackCounter(); 


} 
} 


最 后 ， 为 了 证 明 它 能 正常 工作 ， 你 可 以 编写 如 下 的 简单 测试 。 它 会 播放 
几 个 磁道 并 通过 TrackCounter 断 言 播放 的 数量 。 


程序 清单 4.8 测试 TrackCounter 切 面 


package soundsystem; 

import static org.junit.Assert.*; 

import org.junit.Assert; 

import org.junit.Rule; 

import org.junit.Test; 

import org.junit.contrib.java.lang.system.StandardOutputstreamLog; 
import org.junit.runner.RunWith; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.test.context.ContextConfiguration; 
import org.springframework.test.context.junit4.SpringJUnitA4ClassRunner; 
@RunWith{(SpringJUnit4ClassRunner.class) 
@ContextConfiguration(classes=TrackCounterConfig.class) 

public class TrackCounterTest { 


BRule 
public final StandardOoutputStreamLog log = 
new StandardoutputSstreamLog(}; 


@Autowired 
private CompactDisc cd; 


GaAutowireaQ 
private Trackcounter counter; 


GTest 
public void testTrackCounter() { 
cd.playTrack(1); < 播放 一 些 磁道 
cQ.DlayTrack(2):; 
cd.playTrack (3) ; 
cd.playTrack(3); 
cd.playTrack (3)，; 
cd.playTrack (3); 
cd.playTrack (7); 
cd.playTrack (7); 


assertEquals(1, counter.getPlayCount (1)); < 一 断言 期 望 的 数量 
assertEquals(1, counter .GetPlaycount (2)); 
assertEquals(4, counter.getPlayCount (3)); 
assertEquals(0, counter.getPlayCount (4)}); 


assertEquals(0, counter.getPlayCount (5)); 
assertEquals(0, counter.getPlayCount (6)); 
assertEquals(2, counter.getPlayCount (7)) ; 


到 目前 为 止 ， 在 我 们 所 使 用 的 切面 中 ， 所 包装 的 部 是 被 通知 对 象 的 已 有 
方法 。 但 是 ， 方 法 包 闭 仅仅 是 切面 所 能 实现 的 功能 之 一 。 让 我 们 看 一 下 
如 何 通 过 编写 切面 ， 为 被 通知 的 对 象 引 入 全 新 的 功能 。 


4.3.4 通过 注解 引入 新 功能 
一 些 编程 语言 ， 例 如 Ruby 和 Groovy， 有 开放 类 的 理念 。 它 们 可 以 不 用 


直接 修改 对 象 或 类 的 定义 就 能 够 为 对 象 或 类 增加 新 的 方法 。 不 过 ，Java 
并 不 是 动态 语言 。 一 旦 类 编译 完成 了 ， 我 们 就 很 难 再 为 该 类 添加 新 的 功 








能 了 。 


但 是 如 果 仔 细 想 想 ， 我 们 在 本 章 中 不 是 一 直 在 使 用 切面 这 样 做 吗 ? 当 
然 ， 我 们 还 没有 为 对 象 增加 任何 新 的 方法 ， 但 是 已 经 为 对 象 拥有 的 方法 
ne i di re 
能 为 一 个 对 象 增加 新 的 方法 呢 ? 实际 上 ， 利 用 被 称 为 引入 的 AOP 概 念 
切面 可 以 为 Spring bean 添 加 新 方法 。 


回顾 一 下 ， A em 
理 。 如 果 除 了 实现 这 些 接口 ， 代 理 也 能 暴露 新 接口 的 话 ， 会 怎么 样 呢 ? 
那样 的 话 ， 切 面 所 通知 的 bean 看 起 来 像 是 实现 了 新 的 接口 ， ， 即 便 底层 实 
现 类 并 没有 实现 这 些 接口 也 无 所 谓 。 图 4.7 展 示 了 它们 是 如 何 工 作 的 。 























现 有 的 方法 





被 引入 的 方法 


图 4.7 ”使 用 Spring AOP， 我 们 可 以 为 bean 引 入 新 的 方法 。 
代理 拦截 调用 并 委托 给 实现 该 方法 的 其 他 对 象 


要 注意 的 是 ， 当 引入 接口 的 方法 被 调用 时 ， 代 理会 把 此 调用 委托 
给 实现 了 新 接口 的 条 个 其 他 对 象 。 实 际 上 ， 一 个 bean 的 实现 被 拆 分 到 了 


多 个 类 中 















































为 了 验证 该 主意 能 行 得 通 ， 我 们 为 示例 中 的 所 有 的 Performance 实 现 引 
入 下 面 的 Encoreable 接 口 : 





package concert; 


public interface Encoreable { 
void performEncore( ) ; 


DJ 


暂且 先 不 管 Encoreable 是 不 是 一 个 真正 存在 的 单词 出 ， 我 们 需要 有 一 
种 方式 将 这 个 接口 应 用 到 Performance 实 现 中 。 我 们 现在 假设 你 能 够 访 
问 Performance 的 所 有 实现 ， 并 对 其 进行 修改 ， 让 它们 都 实现 
Encoreable 接 口 。 但 是 ， 从 设计 的 角度 来 看 ， 这 并 不 是 最 好 的 做 法 ， 
并 不 是 所 有 的 Performance 都 是 具有 Encoreab1le 特 性 的 。 另 外 一 方 
面 ， 有 可 能 无 法 修改 所 有 的 Performance 实 现 ， 当 使 用 第 三 方 实现 并 且 
没有 源码 的 时 候 更 是 如 此 。 


值得 庆 笠 的 是 ， 借 助 于 AOP 的 引入 功能 ， 我 们 可 以 不 必 在 设计 上 忌 协 或 
者 侵入 性 地 改变 现 有 的 实现 。 为 了 实现 该 功能 ， 我 们 要 创建 一 个 新 的 切 
面 : 











package concert; 


import org.aspectj.1lang.annotation.Aspect; 
import org.aspectj.lang.annotation.DeclareParents; 


@Aspect 
public class EncoreableIntroducer { 


@DeclareParents(value="concert.Performancet+", 
defaultImpl=DefaultEncoreable.class) 
public static Encoreable encoreable; 





可 以 看 到 ，EncoreableIntroducer 是 一 个 切面 。 但 是 ， 它 与 我 们 之 前 
所 创建 的 切面 不 同 ， 它 并 没有 提供 前 置 、 后 置 或 环绕 通知 ， 而 是 通过 
@DeclareParents 注 解 ， 将 Encoreable 接 口 引 入 到 Performance bean 


@DeclareParents 注 解 由 三 部 分 组 成 : 


e。 Value 属性 指定 了 哪 种 类 型 的 bean 要 引入 该 接口 。 在 本 例 中 ， 也 就 
是 所 有 实现 Performance 的 类 型 。 (标记 符 后 面 的 加 号 表示 
是 Performance 的 所 有 子 类 型 ， 而 不 是 Performance 本 喘 。) 

。 defaultImp1 属 性 指定 了 为 引入 功能 提供 实现 的 类 。 在 这 里 ， 我 们 
指定 的 是 DefaultEncoreable 提 供 实 现 。 


。 QDeclareParents 注 解 所 标注 的 静态 属性 指明 了 要 引入 了 接口 。 
在 这 里 ， 我 们 所 引入 的 是 Encoreable 接 口 。 


和 其 他 的 切面 一 样 ， 我 们 需要 在 Spring 应 用 中 


将 EncoreableIntroducer 声 明 为 一 个 bean: 


<bean class="concert.EncoreableIntroducer"”" /> 


Spring 的 目 动 代理 机 制 将 会 获取 到 和 它 的 声明 ， 当 Spring 发 现 一 个 bean 使 
用 了 @Aspect 注 解 时 ，Spring 束 会 创建 一 个 代理 ， 然 后 将 调用 委托 给 被 
代理 的 bean 或 被 引入 的 实现 ， 这 取决 于 调用 的 方法 属于 被 代理 的 bean 还 
是 属于 被 引入 的 接口 。 


在 Spring 中 ， 注 解 和 自动 代理 提供 了 一 种 很 便利 的 方式 来 创建 切面 。 它 
非常 简单 ， 并 且 只 涉及 到 最 少 的 Spring 配置 。 但 是 ， 面 向 注解 的 切面 声 
明 有 一 个 明显 的 劣势 ,你 必须 能 够 为 通知 类 添加 注解 。 为 了 做 到 这 一 
点 ， 必 须要 有 源码 。 


如 果 你 没有 源码 的 话 ， 或 者 不 想 将 AspectJ 注 解放 到 你 的 代码 之 中 ， 
Spring 为 切面 提供 了 力 外 一 种 可 选 方 案 。 让 我 们 看 一 下 如 何在 Spring 
XML 配置 文件 中 声明 切面 。 








4.4 在 XML 中 声明 切面 

在 本 书 前 面 的 内 容 中 ， 我 曾经 建立 过 这 样 一 种 原则 ， 那 就 是 基于 注解 的 
配置 要 优 于 基于 Java 的 配置 ， 基 于 Java 的 配置 要 优 于 基于 XML 的 配置 。 
但 是 ， 如 果 你 需要 声明 切面 ， 但 是 叉 不 能 为 通知 类 添加 注解 的 时 候 ， 那 
么 就 必须 转向 XML 配置 了 。 


在 Spring 的 aop 命 名 空间 中 ， 提 供 了 多 个 元 素 用 来 在 XML 中 声明 切面 ， 
如 表 4.3 所 示 。 


表 4.3 Spring 的 AOP 配 置 元 素 能 够 以 非 侵入 性 的 方式 声明 切面 


ee 


定义 AOP 后 置 通知 《〈 不 管 被 通知 的 方法 是 否 执行 成 功 ) 
定义 AOP 异 常 通知 
定义 AOP 环 绕 通 知 


PH 


<aopraspectj: 自用 @aspect] 注 解 驱 动 的 切面 


autoproxy> 







































































<aop:before> 定义 一 个 AOP 前 置 通知 











<aop:config> 顶层 的 AOP 配 置 元 素 。 大 多 数 的 caop:*> 元 素 必 须 包 含 
在 <aop:config> 元 素 内 


Sop dc ne 以 透明 的 方式 为 被 通知 的 对 象 引 入 额外 的 接口 


parents> 





我 们 已 经 看 过 了 <aop:aspectj-autoproxy> 元 素 ， 它 能 够 自动 代理 
AspectJ 注 解 的 通知 类 。aop 命 名 空间 的 其 他 元 素 能 够 让 我 们 直接 在 
Spring 配 置 中 声明 切面 ， 而 不 需要 使 用 注解 。 


例如 ， 我 们 重新 看 一 下 Audience 类 ， 这 一 次 我 们 将 它 所 有 的 AspectJ 注 
解 全 部 移 除 掉 : 





package concert; 
public class Audience { 


public void silenceCellPhones() { 
System.out.println("Silencing cell phones"); 


} 


public void takeSeats() { 
System.out.println("Taking seats"); 


} 


public void applause() { 
System.out.println("CLAP CLAP CLAP!!!"); 


} 


public void demandRefund() { 
System.out.println("Demanding a refund"); 


} 





正如 你 所 看 到 的 ，Audience 类 并 没有 任何 特别 之 处 ， 它 就 是 有 几 个 方 
a 我 们 可 以 像 其 他 类 一 样 把 它 注 册 为 Spring 应 用 上 下 文 
*Jbean。 


管 看 起 来 并 没有 什么 差别 ， 人 
pe 我 们 再 稍微 帮助 它 一 把 ， 它 就 能 够 成 为 预期 的 通知 了 。 


4.4.1 声明 前 置 和 后 置 通知 

你 可 以 再 把 那些 AspectJ 注 解 加 回来 ， 但 这 并 不 是 本 贡 的 目的 。 相 反 ， 我 
们 会 使 用 Spring aop 命 名 空间 中 的 一 些 元 素 ， 将 没有 注解 的 Audience 类 
转换 为 切面 。 下 面 的 程序 清单 4.9 展 示 了 所 需要 的 XML。 


程序 清单 4.9 通过 XML 将 无 注解 的 Audience 声 明 为 切面 








<aop:aspect ref="audience'> 引用 audience Bean 


(** concert.Performance.perform{(..))})" 


表演 之 前 





表演 之 后 
(** concert.Performance.perform(..}))}" 
表演 失败 之 后 


(** CoOncerLt . Performance .Pertorm(..))" 











关于 Spring AOP 配 置 元 素 ， 第 一 个 需要 注意 的 事项 是 大 多 数 的 AOP 配 置 
元 素 必须 在 <aop: config> 元 系 的 上 下 文 内 使 用 。 这 条 规则 有 几 种 例外 
ee 我 们 总 是 从 <aop:config> 元 素 
开始 配 


在 <aop:config> 元 素 内 ， 我 们 可 以 声明 一 个 或 多 个 通知 嚣 、 切 面 或 者 
切 点 。 在 程序 清单 4.9 中 ， 我 们 使 用 caop:aspect> 元 素 声明 了 一 个 简单 
的 切面 。ref 元 素 引 用 了 一 个 POJO bean， 访 bean 实现 了 切面 的 功能 
ee ref 元 素 所 引用 的 bean 提 供 了 在 切面 中 通 重 知 所 调 
用 的 方法 。 


该 切面 应 用 了 四 个 不 同 的 通知 。 两 个 <aop :before> 元 素 定 义 了 匹配 切 
点 的 方法 执行 之 前 调用 前 置 通知 方法 一 也 就 是 Audience bean 的 
takeSseats() 和 turnOoffCellPhones() 方 法 〈 由 method 属 性 所 声 





明 ) 。<aop:after-returning> 元 素 定 义 了 一 个 返回 (after- 
returning) 通知 ， 在 切 点 所 匹配 的 方法 调用 之 后 再 调用 applaud() 方 
法 。 同 样 ，<aop:after-throwing> 元 素 定 义 了 异常 (after- 
throwing) 通知 ， 如 果 所 匹配 的 方法 执行 时 抛 出 任何 的 异常 ， 都 将 会 
调用 demandRefund( ) 方 法 。 图 4.8 展 示 了 通知 逻辑 如 何 织 入 到 业务 逻辑 
is 





业务 逻辑 Audience 切 面 通知 逻辑 
<aop:before Ey 
method="takeSeats" audience.takeSeats (); 


pointcut-ref="performance"/> 


<aop:before 
method="turnOffCellPhones" audience.turnOoffCellPhones (); 
pointcut-ref="performance"/> 


performance.perform(); 


<aop‘atter returning 
method="applause" audience.applause (); 
pointcut-ref="performance"/> 


<aop:after-throwing } catch (Exception e) 1{ 
method="demandRefund" audqience .demandqRefund () ; 
pointcut-ref="performance"/>|} 




















图 4.8 Audience 切 面包 含 四 种 通知 ， 它 们 把 通知 逻辑 织 入 进 匹 配 切面 切 点 的 方法 中 


在 所 有 的 通知 元 素 中 ，pointcut 属 性 定义 了 通知 所 应 用 的 切 点 ， 它 的 
值 是 使 用 AspectU 切 点 表达 陈 语法 所 定义 的 切 点 。 


你 或 许 注意 到 所 有 通知 元 素 中 的 pointcut 属 性 的 值 都 是 一 样 的 ， 这 是 
因为 所 有 的 通知 都 要 应 用 到 相同 的 切 点 上 。 


在 基于 AspectJ 注 解 的 通知 中 ， 当 发 现 这 种 类 型 的 重复 时 ， 我 们 使 

用 @Pointcut 注 解 消 除了 这 些 重 复 的 内 容 。 而 在 基于 XML 的 切面 声明 
中 ， 我 们 需要 使 用 caop :pointcut> 元 素 。 如 下 的 XML 展现 了 如 何 将 通 
用 的 切 点 表达 式 抽取 到 一 个 切 点 声明 中 ， 这 样 这 个 声明 就 能 在 所 有 的 通 
知 元 素 中 使 用 了 。 


程序 清单 4.10 ”使 用 <aop:pointcut> 定 义 命 名 切 点 














定义 切 点 


引用 切 点 


引用 切 点 








现在 切 点 是 在 一 个 地 方 定义 的 ， 并 且 被 多 个 通知 元 素 所 引 
用 。<aop:pointcut> 元 素 定 义 了 一 个 id 为 performance 的 切 点 。 同 时 
修改 所 有 的 通知 元 素 ， 用 pointcut-ref 属 性 来 引用 这 个 命名 切 点 。 


正如 程序 清单 4.10 所 展示 的 ，<aop:pointcut> 元 素 所 定义 的 切 点 可 以 
被 同一 个 <aop:aspect> 元 素 之 内 的 所 有 通知 元 素 引 用 。 如 果 想 让 定义 
的 切 点 能 够 在 多 个 切面 使 用 ， 我 们 可 以 把 <aop :pointcut> 元 素 放 

在 <aop:config> 元 素 的 范围 内 。 


4.4.2 ”声明 环绕 通知 


目前 Audience 的 实现 工作 得 非常 棒 ， 但 是 前 置 通知 和 后 置 通 知 有 一 些 
限制 。 有 共 体 来 说 ， 如 果 不 使 用 成 员 变 量 存 储 信息 的 话 ， 在 前 置 通知 和 后 
四 通知 之 间 共 至 信息 非常 拱 烦 。 


例如 ， 假 设 除 了 进 场 关闭 手机 和 表演 结束 后 鼓掌 ， 我 们 还 希望 观众 确保 
一 直 关 注 演 出 ， 并 报告 每 个 参赛 者 表演 了 多 长 时 间 。 使 用 前 置 通知 和 后 
置 通知 实现 该 功能 的 唯一 方式 是 在 前 置 通 知 中 记录 开始 时 间 并 在 某 个 后 
置 通知 中 报告 表演 耗费 的 时 间 。 但 这 样 的 话 我 们 必须 在 一 个 成 员 变 量 中 
保存 开始 时 间 。 因 为 Audience 是 单 例 的 ， 如 果 像 这 样 保 存 状 态 的 话 ， 
将 会 存在 线程 安全 问题 。 


相对 于 前 置 通知 和 后 置 通知 ， 环 绕 通 知 在 这 点 上 有 明显 的 优势 。 使 用 环 
绕 通 知 ， 我 们 可 以 完成 前 置 通知 和 后 置 通知 所 实现 的 相同 功能 ， 而 且 只 

















需要 在 一 个 方法 中 实现 。 因 为 整个 通知 逻辑 是 在 一 个 方法 内 实现 的 ， 
所 以 不 需要 使 用 成 员 变 量 保存 状态 。 


例如 ， 考 虑 程序 清单 4.11 中 新 Audience 类 的 watchPerformance() 方 
法 ， 它 没有 使 用 任何 的 注解 。 


程序 清单 4.11 ”watchPerformance() 方 法 提供 了 AOP 环 绕 通 知 








package concert; 
import org.aspectj.lang.ProceedingJoinPoint; 
Public class Audience { 


public void watchPerformance{ProceedingJoinPoint jp) { 
try 
System.out.println("Ssilencing cell phones"); re 
表演 之 前 
System.out.println("Taking seats"); 


jp.proceed!{); 执行 被 通知 的 方法 


System.out.println("CLAP CLAP CLAP!!!"),; ch i 
i System.out.printin("CLA LAP CLAP 党 表演 成 功 之 后 
} catch {Throwable el { 


System.out.println("Demanding a refund"); 表演 失败 之 后 


} 


在 观众 切面 中 ，watchPerformance() 方 法 包含 了 之 前 四 个 通知 方法 的 
所 有 功能 。 不 过 ， 所 有 的 功能 都 放 在 了 这 一 个 方法 中 ， 因 此 这 个 方法 还 
要 负责 自身 的 异常 处 理 。 


声明 环绕 通知 与 声明 其 他 类 型 的 通知 并 没有 太 大 区 别 。 我 们 所 需要 做 的 
仅仅 是 使 用 <aop:around> 元 素 。 


程序 清单 4.12 ”在 XML 中 使 用 <aop:around> 元 素 声 明 环 绕 通 知 


<aop:config> 
<aop:aspect ref="audience"> 
<aop:pointcut 
id="performance" 


expression="execution(** concert.Performance.perform(..)})" /> 
<aop:around 声明 环线 通知 


pointcut-ref="performance" 
method="watchPerformance"/> 
</aop:aspect> 
</aop:config> 


像 其 他 通知 的 XML 元 素 一 样 ，<aop:around> 指 定 了 一 个 切 点 和 一 个 通 


知 方法 的 名 字 。 在 这 里 ， 我 们 使 用 跟 之 前 一 样 的 切 点 ， 但 是 为 该 切 点 所 
设置 的 method 属 性 值 为 watchPerformance() 方 法 。 


4.4.3 ”为 通知 传递 参数 

在 4.3.3 小 节 中 ， 我 们 使 用 @Aspect]J 注 解 创建 了 一 个 切面 ， 这 个 切面 能 
够 记录 CompactDisc 上 每 个 磁道 播放 的 次 数 。 现 在 ， 我 们 使 用 XML 来 
配置 切面 ， 那 就 看 一 下 如 何 完 成 这 一 相同 的 任务 。 

首先 ， 我 们 要 移 除 掉 TrackCounter 上 所 有 的 @Aspect] 注 解 。 


程序 清单 4.13 ”无 注解 的 TrackCounter 


package soundsystem; 
import java.util.HashMap; 





import java.util .Map; 
public class TrackCounte 


private Map<Integer, Integer> trackCounts 
new HashMap<Integer, Integer>!{); A Ls 
要 声明 为 前 置 通知 的 
public void countTrack(int trackNumber) { 方法 


int currentCount = getPlayCount (trackNumber); 





trackCount (trackNumber, currentCount + 1); 
} 
public int getPlayCount (int trackNumber) { 
return trackCounts.contains Ke ( tr a imber) 
? trackCounts.get (trackNumbe ? 


去 掉 @AspectJ 注 解 后 ，TrackCounter 显 得 有 些 单 注 了 。 现 在 ， 除 非 显 
式 调 用 countTrack() 方 法 ， 否 则 TrackCounter 不 会 记录 磁道 播放 的 数 
量 。 但 是 ， 借助 一 点 Spring XML 配置 ， 我 们 能 够 让 TrackCounter 重 新 
变 为 切面 。 


如 下 的 程序 清单 展现 了 完整 的 Spring 配置 ， 在 这 个 配置 中 声明 了 
TrackCounter bean 和 BlankDisc bean， 并 将 TrackCounter 转 化 为 切 
面 和 


程序 清单 4.14 在 XML 中 将 TrackCounter 配 置 为 参数 化 的 切面 


<?2xml Version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation= 
"http://www.springframework.org/schema/aop 
http://www.springframework .org/schema/aop/spring-aop.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<bean id="trackCounter" 
class="soundsystem.TrackCounter" /> 4 TrackCounter bean 


<bean id="cd" 
class="soundsystem.BlankDisc"> BlankDisc bean 
<property name="title" 
value="Sgt. Pepper's Lonely Hearts Club Band" /> 
<property name="artist" value="The Beatles" /> 
<property name='"'tracks"> 
<list> 
<value>Sgt. Pepper's Lonely Hearts Club Band</value> 
<value>With a Little Help from My Friends</value> 
<value>Lucy in the Sky with Diamonds</value> 
<value>Getting Better</value> 
<value>Fixing a Hole</value> 


<!-- ...Oother tracks omitted for brevity... ~--> 
</list> 
</property> 
</bean> 


<aop:config> 将 TrackCounter 声明 为 切面 
<aop:aspect ref="trackCounter"> Es 
<aop:pointcut id="trackPlayed" expression= 
"execution{* soundsystem.CompactDisc.playTrack(int)) 
and args (trackNumber)" /> 


<aop:before 
pointcut-ref="trackPlayed" 
method="countTrack"/> 
</aop:aspect> 
</aop:config> 
</beans> 


可 以 看 到 ， 我 们 使 用 了 和 前 面相 同 的 aop 命 名 空间 XML 元 系 ， 它 们 会 将 

POJO 声 明 为 切面 。 唯 一 明显 的 差别 在 于 切 点 表达 式 中 包含 了 一 个 参 

数 ， 这 个 参数 会 传递 到 通知 方法 中 。 如 果 你 将 这 个 表达 陈 与 程序 清单 

4.6 中 的 表达 式 进行 对 比 会 发 现 它们 几乎 是 相同 的 。 唯 一 的 差别 在 于 这 

os Us 《因为 在 XML 中 ,“&" 符 号 会 被 解析 为 实 
I 开始 ) 


我 们 通过 练习 已 经 使 用 Spring 的 aop 命 名 空间 声明 了 几 个 基本 的 切面 ， 
那么 现在 让 我 们 看 一 下 如 何 使 用 aop 命 名 空间 声明 引入 切面 。 


4.4.4 通过 切面 引入 新 的 功能 


在 前 面 的 4.3.4 小 节 中 ， 我 癌 你 展现 了 如 何 借助 AspectJ 的 
@DeclareParents 注 解 为 被 通知 的 方法 神奇 地 引入 新 的 方法 。 但 是 
AOP 引 入 并 不 是 AspectJ 特 有 的 。 使 用 Spring aop 命 名 空间 中 的 
<aop:declare-parents> 元 素 ， 我 们 可 以 实现 相同 的 功能 。 


如 下 的 XML 代码 片段 与 之 前 基于 AspectJ 的 引入 功能 是 相同 : 


<aop:aspect> 
<aop:declare-parents 
types-matching="concert.Performance+" 


ijmplement-interface="concert.Encoreable" 
default-impl="concert.DefaultEncoreable" 
/> 

</aop:aspect> 





顾名思义 ，<aop:declare-parents> 声 明了 此 切面 所 通知 的 bean 要 在 
它 的 对 象 层次 结构 中 拥有 新 的 父 类 型 。 有 具体 到 本 例 中 ， 类 型 匹 

配 Performance 接 口 〈 由 types-matching 属 性 指定 ) 的 那些 bean 在 父 
类 结构 中 会 增加 Encoreable 接 口 (由 ijmplement-interface 属 性 指 

定 ) 。 最 后 要 解决 的 问题 是 Encoreable 接 口中 的 方法 实现 要 来 自 于 何 
处 。 


这 里 有 两 种 方式 标识 所 引入 接口 的 实现 。 在 本 例 中 ， 我 们 使 
用 default-imp1 属 性 用 全 限定 类 名 来 显 式 指 定 Encoreab1le 的 实现 。 或 
者 ， 我 们 还 可 以 使 用 delegate-ref 属 性 来 标识 。 




















<aop:aspect> 
<aop:declare-parents 
types-matching="concert.Performance+" 


ijmplement-interface="concert.Encoreable" 
delegate-ref="encoreableDelegate" 
/> 

</aop:aspect> 





delegate-ref 属 性 引用 了 一 个 Spring bean 作 为 引入 的 委托 。 这 需要 在 
Spring 上 下 文中 存在 一 个 ID 为 encoreableDelegate 的 bean。 


<bean id="encoreableDelegate" 





class="concert.DefaultEncoreable" /> 


使 用 default-impl 来 直接 标识 委托 和 间接 使 用 delegate-ref 的 区 别 在 
于 后 者 是 Spring bean， 它 本 里 可 以 被 注入 、 通 知 或 使 用 其 他 的 Spring 配 
置 。 


4.5 注入 AspectJ 切 面 


虽然 Spring AOP 能 够 满足 许多 应 用 的 切面 需求 ， 但 是 与 AspectJ 相 比 ， 
Spring AOP 是 一 个 功能 比较 弱 的 AOP 解 决 方案 。AspectJ 提 供 了 Spring 
AOP 所 不 能 文 持 的 许多 类 型 的 切 点 。 


例如 ， 当 我 们 需要 在 创建 对 象 时 应 用 通知 ， 构 造 需 切 点 就 非常 方便 。 不 
像 某 些 其 他 面向 对 象 语言 中 的 构造 促 ，Java 构 造 占 不 同 于 其 他 的 正常 方 
法 。 这 使 得 Spring 基于 代理 的 AOP 无 法 把 通知 应 用 于 对 象 的 创建 过 程 。 


对 于 大 部 分 功能 来 讲 ，AspectJ 切 面 与 Spring 是 相互 独立 的 。 虽 然 它 们 可 
以 织 入 到 任意 的 Java 应 用 中 ， 这 也 包括 了 Spring 应 用 ， 但 是 在 应 用 
AspectJ 切 面 时 几乎 不 会 涉及 到 Spring。 


但 是 精心 设计 且 有 意义 的 切面 很 可 能 依赖 其 他 类 来 完成 它们 的 工作 。 如 
果 在 执行 通知 时 ， 切 面 依赖 于 一 个 或 多 个 类 ， 我 们 可 以 在 切面 内 部 实例 
化 这 些 协作 的 对 象 。 但 更 好 的 方式 是 ， 我 们 可 以 借助 Spring 的 依赖 注入 
把 bean 装 配 进 AspectJ 切 面 中 。 

为 了 演示 ， 我 们 为 上 面 的 演出 创建 一 个 新 切面 。 具 体 来 讲 ， 我 们 以 切面 
的 方式 创建 一 个 评论 员 的 角色 ， 他 会 观看 演出 并 且 会 在 演出 之 后 提供 一 
些 批评 意见 。 下 面 的 CriticAspect 就 是 一 个 这 样 的 切面 。 


程序 清单 4.15 ”使 用 AspectJ 实 现 表演 的 评论 员 











注入 CriticismEngine 


public void setCriticismEngine (CriticismEngine criticismEngine) { 


CriticAspect 的 主要 职责 是 在 表演 结束 后 为 表演 发 表 评 论 。 程 序 清单 
4.15 中 的 performance() 切 点 匹配 perform() 方 法 。 当 它 


与 afterReturning() 通 知 一 起 配合 使 用 时 ， 我 们 可 以 让 该 切面 在 表演 
结束 时 起 作用 。 

程序 清单 4.15 有 趣 的 地 方 在 于 并 不 是 评论 员 上 自己 发 表 评论 ， 实 际 

上 ，CriticAspect 与 一 个 CriticismEngine 对 象 相 协作 ， 在 表演 结束 
时 ， 调 用 该 对 象 的 getCriticism() 方 法 来 发 表 一 个 苛刻 的 评论 。 为 了 
避免 CriticAspect 和 CriticismEngine 之 间 产 生 不 必要 的 耦合 ， 我 们 
通过 Setter 依 赖 注 入 为 CriticAspect 设 置 CriticismEngine。 图 4.9 展 


不 了 此 关系 。 
| CriticismEngine 
promemnem 


图 4.9 切面 也 需要 注入 。 像 其 他 的 bean 一 样 
Spring 可 以 为 AspectJ 切 面 注入 依赖 










getCriticism() 




















-> 


CriticismEngine 上 自身 是 声明 了 一 个 简单 getCriticism() 方 法 的 接 
口 。 程 序 清 单 4.16 为 CriticismEngine 的 实现 。 


程序 清单 4.16 ”要 注入 到 CriticAspect 中 的 CriticismEngine 实 现 





package com.springinaction.springidol; 
public class CriticismEngineImpl implements CriticismEngine { 
public CriticismEngineImp1() {} 


public String getCriticism() { 
int i = (int) (Math.random() * criticismpPool.length); 
return criticismpPool[i]; 


} 


// injected 

private String[] criticismPool; 

public void setCriticismpool(String[] criticismPool) { 
this.criticismPool = criticismPool; 


} 


Re 


CriticismEngineImp1 实 现 了 CriticismEngine 接 口 ， 通 过 从 注入 的 
评论 池 中 随机 选择 一 个 苛刻 的 评论 。 这 个 类 可 以 使 用 如 下 的 XML 声 明 
为 一 个 Spring bean。 


<bean id="criticismEngine" 
class="com.springinaction.springidol.CriticismEngineImpl"> 
<property name="criticisms"> 
<list> 
<value>Worst performance ever!</value> 


<value>I laughed, I cried, then I realized I was at the 
wrong show.</value> 
<value>A must see show!</value> 
</l1ist> 
</property> 
</bean> 








到 目前 为 止 ， 一切 顺利 。 我 们 现在 有 了 一 个 要 赋予 CriticAspect 的 
Criticism-Engine 实 现 。 剩 下 的 就 是 为 CriticAspect 装 
配 CriticismEngineImple。 


在 展示 如 何 实 现 注 入 之 前 ， 我 们 必须 清楚 AspectJ 切 面 根 本 不 需要 Spring 
就 可 以 织 入 到 我 们 的 应 用 中 。 如 果 想 使 用 Spring 的 依赖 注入 为 AspectJ 切 
面 注 入 协作 者 ， 那 我 们 就 需要 在 Spring 配置 中 把 切面 声明 为 一 个 Spring 
配置 中 的 <bean>。 如 下 的 <bean> 声 明 会 把 criticismEnginebean 注 入 
到 CriticAspect 中 : 








<bean class="com.springinaction.springidol.CriticAspect" 
factory-method="aspectOf"> 


<property name="criticismEngine" ref="criticismEngine" /> 
</bean> 





很 大 程度 上 ，<bean> 的 声明 与 我 们 在 Spring 中 所 看 到 的 其 他 <bean> 配 
置 并 没有 太 多 的 区 别 ， 但 是 最 大 的 不 同 在 于 使 用 了 factory-method 属 
性 。 通 常情 况 下 ，Spring bean 由 Spring 容 器 初始 化 ， 但 是 AspectJ 切 面 是 
由 AspectJ 在 运行 期 创建 的 。 等 到 Spring 有 机 会 为 CriticAspect 注 

入 CriticismEngine 时 ，CriticAspect 已 经 被 实例 化 了 。 


因为 Spring 不 能 负责 创建 CriticAspect， 那 就 不 能 在 Spring 中 简单 地 把 





CriticAspect 声 明 为 一 个 bean。 相 反 ， 我 们 需要 一 种 方式 为 Spring 获得 
已 经 由 AspectJ 创 建 的 CiticAspect 实 例 的 句柄 ， 从 而 可 以 注 

入 CriticismEngine。 笠 好， 所 有 的 AspectJ 切 面 都 提供 了 一 个 静态 的 

aspectof() 方 法 ， 该 方法 返回 切面 的 一 个 单 例 。 所 以 为 了 获得 切面 的 

实例 ， 我 们 必须 使 用 factory-method 来 调用 asepctof() 方 法 而 不 是 调 
用 CriticAspect 的 构造 器 方法 。 


简 而 言 之 ，Spring 不 能 像 之 前 那样 使 用 <bean> 声 明 来 创建 一 

个 CriticAspect 实 例 一 一 它 已 经 在 运行 时 由 AspectJ 创 建 完成 了 。 
Spring 需 要 通过 aspect0f() 工 三 方法 获得 切面 的 引用 ， 然 后 像 <bean> 
元 素 规定 的 那样 在 该 对 象 上 执行 依赖 注入 。 








4.6 小结 


AOP 是 面 问 对象 编 程 的 一 个 强大 补充 。 通 过 AspectUJ， 我 们 现在 可 以 把 之 
前 分 散在 应 用 各 处 的 行为 放 入 可 重用 的 模块 中 。 我 们 显示 地 声明 在 何 处 
如 何 应 用 该 行为 。 这 有 效 减 少 了 代码 见 余 ， 并 让 我 们 的 类 关注 上 自身 的 主 








Spring 提供 了 一 个 AOP 框 桨 ， 让 我 们 把 切面 插入 到 方法 执行 的 周围 。 现 
在 我 们 已 经 学 会 如 何 把 通知 织 入 前 置 、 后 置 和 环绕 方法 的 调用 中 ， 以 及 
为 处 理 异 常 增加 上 自 定 义 的 行为 。 


关于 在 Spring 应 用 中 如 何 使 用 切面 ， 我 们 可 以 有 多 种 选择 。 通 过 使 
0 
得 非 第 简单 。 


最 后 ， 当 Spring AOP 不 能 满足 需求 时 ， 我 们 必须 转 回 更 为 强大 的 
AspectJ。 对 于 这 些 场景 ， 我 们 了 解 了 如 何 使 用 Spring 为 AspectU 切 面 注入 
依赖 。 


此 时 此 刻 ， 我 们 已 经 上 覆 冰 了 Spring 框架 的 基础 知识 ， 了 解 到 如 何 配置 
Spring 容 锋 以 及 如 何 为 Spring 管理 的 对 象 应 用 切面 。 正 如 我 们 所 看 到 
的 ， 这 些 核心 技术 为 创建 松散 耦合 的 应 用 更 定 了 坚实 的 基础 。 


现在 ， 我 们 越过 这 些 基础 的 内 容 ， 看 一 下 如 何 使 用 Spring 构建 真实 的 应 
用 。 从 下 一 章 开 始 ， 首 先 看 到 的 是 如 何 使 用 Spring 构建 Web 应 用 。 








[上 对 应 的 英文 单词 词根 为 encore， 指 的 是 演唱 会 演出 结束 后 应 观众 要 求 
进行 返 场 表演 。 译 者 注 





第 2 部 分 “Web 中 的 Spring 


Spring 通常 用 来 开发 Web 应 用 。 因 此 ， 在 第 2 部 分 中 ， 将 会 看 到 如 何 使 用 
Spring 的 MVC 框 架 为 应 用 程序 添加 Web 前 端 。 


在 第 5 章 “ 构 建 Spring Web 应 用 ”中 ， 你 将 会 学 习 到 Spring MVC 的 基本 用 
法 ， 它 是 构建 在 Spring 理念 之 上 的 一 个 Web 框架 。 我 们 将 会 看 到 如 何 编 
写 处 理 Web 请 求 的 控制 器 以 及 如 何 透 明 地 绑 定 请 求 参数 和 负载 到 业务 对 
象 上 ， 同 时 它 还 提供 了 数据 检验 和 错误 处 理 的 功能 。 


在 第 6 章 “ 演 染 Web 视 图 ”中 ， 将 会 基于 第 5 章 的 内 容 继 续 讲 解 ， 展 现 了 如 
何 得 到 Spring MVC 控 制 器 所 生成 的 模型 数据 ， 并 将 其 洽 染 为 用 户 浏览 器 
中 的 HIML。 这 一 章 的 讨论 包括 JavaServer Pages (JSP) 、Apache Tiles 
和 Thymeleaf 模 板 。 


在 第 7 章 “Spring MVC 的 高 级 技术 ”中 ， 将 会 学 习 到 构建 Web 应 用 时 的 一 
些 高 级 技术 ， 包 括 自 定义 Spring MVC 配 置 、 人 处理 multipart 文 件 上 传 、 处 
理 异 常 以 及 使 用 flash 属 性 跨 请 求 传 递 数 据 。 


第 8 章 , “使 用 Spring Web Flow” 将 会 为 你 展示 如 何 使 用 Spring Web Flow 
来 构建 会 话 式 、 基 于 流程 的 Web 应 用 程序 。 


鉴于 安全 是 很 多 应 用 程序 的 重要 关注 点 ， 因 此 第 9 章 “ 保 护 Web 应 用 ”将 
人 Spring Security 来 为 Web 应 用 程序 提供 安全 性 ， 保 护 
心 用 和 言 已. o 








第 5 章 ”构建 Spring Web 应 用 程序 
本 章 内 容 ， 


。 映射 请 求 到 Spring 控 制 右 
。 透明 地 绑 定 表单 参数 
。 校 验 表单 提交 


作为 企业 级 Java 开 及 者 ， 你 可 能 开发 过 一 些 基于 Web 的 应 用 程序 。 对 于 
很 多 Java 开 发 人 员 来 说 ， 基 于 Web 的 应 用 程序 是 他 们 主要 的 关注 点 。 如 
果 你 有 这 方面 经 验 的 话 ， 你 会 意识 到 这 种 系统 所 面临 的 挑战 。 具 体 来 
讲 ， 状 态 管理 、 工 作 流 以 及 验证 都 是 需要 解决 的 重要 特性 。HTTP 协 议 
的 无 状态 性 决定 了 这 些 问题 都 不 那么 容易 解决 。 


Spring 的 Web 框 架 束 是 为 了 帮 你 解决 这 些 关 注 点 而 设计 的 。Spring MVC 
基于 模型 -视图 -控制 器 〈Model-View-Controller，MVC ) 模式 实现 ， 它 
能 够 帮 你 构建 像 Spring 框 架 那 样 灵活 和 松 耘 合 的 Web 应 用 程序 。 


在 本 章 中 ， 我 们 将 会 介绍 Spring MVC Web 框 架 ， 并 使 用 新 的 Spring 
MVC 注 解 来 构建 处 理 各 种 Web 请 求 、 参 数 和 表单 输入 的 控制 器 。 在 深入 
介绍 Spring MVC 之 前 ， 让 我 们 先 总 体 上 介绍 一 下 Spring MVC， 并 建立 
起 Spring MVC 运 行 的 基本 ”配置 。 











5.1 Spring MVC 起步 


你 见 到 过 孩子 们 的 捕 鼠 器 游戏 吗 ? 这 真是 一 个 疯狂 的 游戏 ， 它 的 目标 是 
发 送 一 个 小 钢 球 ， 让 它 经 过 一 系列 稀奇 古怪 的 装置 ， 最 后 触发 捕 鼠 器 。 
小 钢 球 穿 过 各 种 复杂 的 配件 ， 从 一 个 斜坡 上 深 下 来 ， 被 跷 路 板 弹 起 ， 绕 
过 一 个 微型 摩天 轮 ， 然 后 被 橡胶 靳 从 桶 中 跑 出 去 。 经 过 这 些 后 ， 小 钢 球 
会 对 那 只 可 怜 又 无 率 的 橡胶 老鼠 进行 捕获 。 


乍 看 上 去 ， 你 会 认为 Spring MVC 框 染 与 捕 妇 占有 些 类 似 。Spring 将 请 求 
在 调度 Servlet、 处 理 器 映射 (handler mapping) 、 控 制 器 以 及 视图 解析 

器 〈view resolver) 之 间 移 动 ， 而 捕 鼠 占 中 的 钢 球 则 会 在 各 种 和 斜坡、 践 

跑 板 以 及 摩天 轮 之 间 深 动 。 但 是 ， 不 要 将 Spring MVC 与 Rube Goldberg- 
esque 捕 鼠 器 游戏 做 过 多 比较 。 每 一 个 Spring MVC 中 的 组 件 都 有 特定 的 

目的 ， 并 且 它 也 没有 那么 复杂 。 


让 我 们 看 一 下 请 求 是 如 何 从 客 己 端 发 起 ， 经 过 Spring MVC 中 的 组 件 ， 最 
终 再 返回 到 客户 端的 。 





5.1.1 跟踪 Spring MVC 的 请 求 


每 当 用 户 在 Web 浏 览 器 中 点 击 链接 或 提交 表单 的 时 候 ， 请 求 就 开始 工作 
了 。 对 请 求 的 工作 描述 就 像 是 快递 投 送 员 。 与 邮局 投递 员 或 FedEx 投 送 
员 一 样 ， 请 求 会 将 信息 从 一 个 地 方 带 到 另 一 个 地 方 。 


请 求 是 一 个 十 分 坚 忙 的 家 伙 。 从 离开 浏览 器 开始 到 获取 咽 应 返回 ， 它 会 
经 历 好 多 站 ， 在 每 站 都 会 留 下 一 些 信 息 同 时 也 会 带 上 其 他 信息 。 图 5.1 
展示 了 请 求 使 用 Spring MVC 所 经 历 的 所 有 站 点 。 



















控制 大 


Si 
请 求 o DispatcherServlet 
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图 5.1 一 路 上 请 求 会 将 信息 带 到 很 多 站 点 ， 并 生产 期 望 的 结果 


在 请 求 离开 浏览 器 时 @， 会 带 有 用 户 所 请 求 内 容 的 信息 ， 人 至 少 会 包含 请 
求 的 URL。 但 是 还 可 能 带 有 其 他 的 信息 ， 例 如 用 户 提 交 的 表单 信息 。 


请 求 旅程 的 第 一 站 是 Spring 的 DispatcherServlet。 与 大 多 数 基 于 Java 
的 Web 框 架 一 样 ，Spring MVC 所 有 的 请 求 都 会 通过 一 个 前 端 控制 器 
(front controller) Servlet。 前 病 控 制 器 是 常用 的 Web 应 用 程序 模式 ， 在 
这 里 一 个 单 实例 的 Servlet 将 请 求 委 托 给 应 用 程序 的 其 他 组 件 来 执行 实际 
的 处 理 。 在 Spring MVC 中 ，DispatcherServlet 束 是 前 端 控制 器 。 














DispatcherServlet 的 任务 是 将 请 求 发 送 给 Spring MVC 控 制 器 
Ccontroller) 。 控 制 器 是 一 个 用 于 处 理 请 求 的 Spring 组 件 。 在 典型 的 应 
用 程序 中 可 能 会 有 多 个 控制 器 ，DispatcherServlet 需 要 知道 应 该 将 
请 求 发 送 给 哪个 控制 器 。 所 以 DispatcherServlet 以 会 查询 一 个 或 多 
个 处 理 右 映射 (handler mapping ) @ 来 确定 请 求 的 下 一 站 在 哪里 。 处 理 
器 映射 会 根据 请 求 所 携带 的 URL 信 息 来 进行 决策 。 


一 旦 选择 了 合适 的 控制 器 ，DispatcherServlet 会 将 请 求 发 送 给 选中 
的 控制 器 @。 到 了 控制 器 ， 请 求 会 扼 下 其 负载 (用 户 提 交 的 信息 〉 并 耐 
心 等 待 控 制 器 处 理 这 些 信 息 。〔 实 际 上 ， 设 计 良 好 的 控制 器 本 身 只 处 理 
很 少 甚至 不 处 理工 作 ， 而 是 将 业务 逻辑 委托 给 一 个 或 多 个 服务 对 象 进行 
处 理 。) 


控制 器 在 完成 逻辑 处 理 后 ， 通 常会 产生 一 些 信息 ， 这 些 信息 需要 返回 给 
用 户 并 在 浏览 器 上 显示 。 这 些 信息 被 称 为 模型 (model) 。 不 过 仅仅 给 
用 户 返 回 原始 的 信息 是 不 够 的 一 一 这 些 信息 需要 以 用 户 友好 的 方式 进行 














格式 化 ， 一 般 会 是 HTML。 所 以 ， 信 息 需 要 发 送 给 一 个 视图 (view) ， 
通常 会 是 JSP。 


控制 占 所 做 的 最 后 一 件 事 就 是 将 模型 数据 打包 ， 并 且 标 示 出 用 于 泻 染 输 
出 的 视图 名 。 它 接 下 来 会 将 请 求 连同 模型 和 视图 名 发 送 回 
DispatcherServlete®. 


这 样 ， 控 制 器 就 不 会 与 特定 的 视图 相 硬 合 ， 传 递 给 
DispatcherServlet 的 视图 名 并 不 直接 表示 某 个 特定 的 JSP。 实 际 上 ， 
它 甚 至 并 不 能 确定 视图 就 是 JSP。 相 反 ， 它 仅仅 传递 了 一 个 逻辑 名 称 ， 
这 个 名 字 将 会 用 来 查找 产生 结果 的 真正 视图 。DispatcherServlet 将 
会 使 用 视图 解析 器 (view resolver) @ 来 将 逻辑 视图 名 匹配 为 一 个 特定 的 
视图 实现 ， 它 可 能 是 也 可 能 不 是 JSP。 


既然 DispatcherServlet 己 经 知道 由 哪个 视图 演 染 结果 ， 那 请 求 的 任 
务 基本 上 也 就 完成 了 。 它 的 最 后 一 站 是 视图 的 实现 (可 能 是 JSP) @， 在 
这 里 它 交 付 模 型 数据 。 请 求 的 任务 就 完成 了 。 视 图 将 使 用 模型 数据 泻 染 
这 个 输出 会 通过 啊 应 对象 传 递 给 客户 端 〈 不 会 像 听 上 去 那样 硬 编 
与) @。 


可 以 看 到 ， 请 求 要 经 过 很 多 的 步骤 ， 最 终 才能 形成 返回 给 客户 端的 啊 
应 。 大 多 数 的 步骤 都 是 在 Spring 框架 内 部 完成 的 ， 也 就 是 图 5.1 所 示 的 组 
件 中 。 尽 管 本 章 的 主要 内 容 都 关注 于 如 何 编写 控制 右 ， 但 在 此 之 前 我 们 
首先 看 一 下 如 何 搭建 Spring MVC 的 基础 组 件 。 





























5.1.2 ”搭建 Spring MVC 


基于 图 5.1， 看 上 去 我 们 需要 配置 很 多 的 组 成 部 分 。 竺 好 ， 借 助 于 最 近 

几 个 Spring 新 版 本 的 功能 增强 ， 开 始 使 用 Spring MVC 变 得 非常 简单 了 。 

现在 ， 我 们 要 使 用 最 简单 的 方式 来 配置 Spring MVC: 所 要 实现 的 功能 仪 
在 第 7 章 中 ， 我 们 会 看 一 些 其 他 的 配置 

迁 项 。 


配置 DispatcherServlet 





DispatcherServlet 是 Spring MVC 的 核心 。 在 这 里 请 求 会 第 一 次 接触 
到 框架 ， 它 要 负责 将 请 求 路 由 到 其 他 的 组 件 之 中 。 


按照 传统 的 方式 ， 像 DispatcherServlet 这 样 的 Servlet 会 配置 在 
web.xml 文 件 中 ， 这 个 文件 会 放 到 应 用 的 WAR 包 里 面 。 当 然 ， 这 是 配 
置 DispatcherServlet 的 方法 之 一 。 人 但是， 借助 于 Servlet 3 规范 和 
Spring 3.1 的 功能 增强 ， 这 种 方式 已 经 不 是 唯一 的 方案 了 ， 这 也 不 是 我 们 
本 章 所 使 用 的 配置 方法 。 


我 们 会 使 用 Java 将 DispatcherServlet 配 置 在 Servlet 容 器 中 ， 而 不 会 再 
使 用 web.xml 文 件 。 如 下 的 程序 清单 展示 了 所 需 的 Java 类 。 


程序 清单 5.1 配置 DispatcherServlet 





package spittr.config; 
import org.springframework.web.servlet.support. 
AbstractAnnotationConfigDispatcherServletInitializer; 


public class SpittrWebAppInitializer 
extends AbstractAnnotationConfigDispatcherServletInitializer { 


GOverride 号 
后 不 将 DispatcherServlet 映射 到 


protected String[j getServletMappings() ({ 
return new String{[] { "/" }; 


Override 

protected Class<?>[] getRootConfigClasses{() { 
return new Class<?>[] { RootConfig.class }; 

} 

Override 

protected Class<?>[] getServletConfigClasses() { 本 指定 配置 类 
return new Class<?>[] { WebConfig.class }; 


} 


在 我 们 深入 介绍 程序 清单 5.1 之 前 ， 你 可 能 想 知 道 spitr 到 底 是 什么 意 
思 。 这 个 类 的 名 字 是 spittrwebAppInitializer， 它 位 于 名 为 
spittr.config 的 包 中 。 我 稍 后 会 对 其 进行 介绍 〈 在 5.1.3 小 节 中 ) ， 但 现 
在 ， 你 只 需要 知道 我 们 所 要 创建 的 应 用 名 为 Spittr。 

要 理解 程序 清单 5.1 是 如 何 工 作 的 ， 我 们 可 能 只 需要 知道 扩 

展 AbstractAnnotation-ConfigDispatcherServletInitializer 的 


任意 类 都 会 自动 地 配置 Dijspatcher-Servlet 和 Spring 应 用 上 下 文 ， 
Spring 的 应 用 上 下 文 会 位 于 应 用 程序 的 Servlet 上 下 文 之 中 。 


AbstractAnnotationConfigDispatcherServletInitializer 训 析 


如 果 你 坚持 要 了 人 解 更 多 细节 的 话 ， 那 束 看 这 里 吧 。 在 Servlet 3.0 环 境 


中 ， 容 器 会 在 类 路 径 中 查找 实现 
javax.servlet.ServletContainerInitializer 接 口 的 类 ， 如 果 能 


发 现 的 话 ， 束 会 用 它 来 配置 Servlet 容 器 。 


Spring 提供 了 这 个 接口 的 实现 ， 名 

为 SpringServletContainerInitializer， 这 个 类 反 过 来 又 会 查找 实 
现 WebApplicationInitializer 的 类 并 将 配置 的 任务 交 给 它们 来 完 
成 。Spring 3.2 引 入 了 一 个 便利 的 WebApplicationInitializer 基 础 实 
现 ， 也 就 

是 AbstractAnnotationConfigDispatcherServletInitializer。 
因为 我 们 的 Spittr-WebAppInitializer 扩 展 了 
AbstractAnnotationConfig DispatcherServlet- 

Initializer (同时 也 就 实现 了 WebApplicationInitializer)， 
此 当 部 署 到 Servlet 3.0 容 器 中 的 时 候 ， 容 器 会 自动 友 现 它 ， 并 用 它 来 配 
置 Servlet 上 下 文 。 


尽管 它 的 名 字 很 长 ， 但 

是 AbstractAnnotationConfigDispatcherServlet-Initializer 使 
用 起 来 很 简便 。 在 程序 清单 5.1 中 ，SpittrWebAppInitializer 重 写 了 
A 
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第 一 个 方法 是 getServletMappings()， 它 会 将 一 个 或 多 个 路 径 映 射 
到 DispatcherServlet 上 。 在 本 例 中 ， 它 映射 的 是 “”， 这 表示 和 它 会 是 
应 用 的 默认 Servlet。 它 会 处 理 进 入 应 用 的 所 有 请 求 。 


为 了 理解 其 他 的 两 个 方法 ， 我 们 首先 要 理解 DispatcherServlet 和 一 
个 Servlet 监 听 器 〈 也 就 是 ContextLoaderListener) 的 关系 。 


两 个 应 用 上 下 文 之 间 的 故事 


当 DispatcherSserv1let 局 动 的 时 候 ， 它 会 创建 Spring 应 用 上 下 文 ， 并 加 
载 配置 文件 或 配置 类 中 所 声明 的 bean。 在 程序 清单 5.1 的 
getServletConfigClasses() 方 法 中 ， 我 们 要 求 DispatcherServlet 
a 使 用 定义 在 WebConfig 配 置 类 (使 用 Java 配 置 ) 中 
入 bean 。 


但 是 在 Spring Web 应 用 中 ， 通 常 还 会 有 男 外 一 个 应 用 上 下 文 。 另 外 的 这 
个 应 用 上 下 文 是 由 ContextLoaderListener 创 建 的 。 


我 们 希望 DispatcherServlet 加 载 包 含 Web 组 件 的 bean， 如 控制 器 、 视 
图 解析 器 以 及 处 理 器 映射 ， 而 ContextLoaderListener 要 加 载 应 用 中 
的 其 他 bean。 这 些 bean 通 常 是 驱动 应 用 后 病 的 中 间 层 和 数据 层 组 件 。 


实际 

上 , AbstractAnnotationConfigDispatcherServletInitializer 
会 同时 创建 DispatcherServlet 和 
ContextLoaderListener。GetServlet-ConfigClasses() 方 法 返回 
的 带 有 @Configuration 注 解 的 类 将 会 用 来 定义 DispatcherServlety 
用 上 下 文中 的 bean。getRootConfigClasses() 方 法 返回 的 带 

有 @Configuration 注 解 的 类 将 会 用 来 配置 ContextLoaderListener 
创建 的 应 用 上 下 文中 的 bean。 


在 本 例 中 ， 根 配置 定义 在 RootConfig 中 ，DispatcherServlet 的 配置 
声明 在 WebConfig 中 。 稍 后 我 们 将 会 看 到 这 两 个 类 的 内 容 。 


需要 注意 的 是 ， 通 过 
AbstractAnnotationConfigDispatcherServlet-Initializer 来 配 
置 DispatcherServlet 是 传统 web.xml 方 式 的 替代 方案 。 如 果 你 愿意 的 
话 ， 可 以 同时 包含 web.xml 和 
AbstractAnnotationConfigDispatcher-ServletInitializer, 但 
这 其 实 并 没有 必要 。 


如 果 按 照 这 种 方式 配置 DispatcherServlet， 而 不 是 使 用 web.xml 的 
话 ， 那 唯一 问题 在 于 它 只 能 部 署 到 文 持 Servlet 3.0 的 服务 器 中 才能 正常 
工作 ， 如 Tomcat 7 或 更 高 版 本 。Servlet 3.0 规 范 在 2009 年 12 月 份 就 发 布 
了 ， 因 此 很 有 可 能 你 会 将 应 用 部 晋 到 文 持 Servlet 3.0 的 Servlet 容 右 之 中 。 


如 有 果 你 还 没有 使 用 支持 Servlet 3.0 的 服务 器 ， 那 么 

在 AbstractAnnotation-ConfigDispatcherServletInitializer 子 
类 中 配置 DispatcherServlet 的 方法 束 不 适合 你 了 。 你 别 无 选择 ， 只 
能 使 用 web.xml 了 。 我 们 将 会 在 第 7 章 学 习 web.xml 和 其 他 配置 选项 。 但 
现在 ， 我 们 先 看 一 下 程序 清单 5.1 中 所 引用 的 WebConfig 和 
RootConfig， 了 解 一 下 如 何 启用 Spring MVC。 
































启用 Spring MVC 


我 们 有 多 种 方式 来 配置 DispatcherSservlet， 与 之 类 似 ， 启 用 Spring 





MVC 组 件 的 方法 也 不 仅 一 种 。 以 前 ，Spring 是 使 用 XML 进行 配置 的 ， 你 
可 以 使 用 <mvc:annotation-driven> 启 用 注解 驱动 的 Spring MVC。 


我 们 会 在 第 7 章 讨 论 Spring MVC 配 置 可 选项 的 时 候 ， 再 讨论 
<mvc:annotation-driven>。 不 过 ， 现 在 我 们 会 让 Spring MVC 的 搭建 
过 程 义 可 能 简单 并 基于 Java 进 行 配置 。 


我 们 所 能 创建 的 最 简单 的 Spring MVC 配 置 就 是 一 个 带 
有 @EnableWebMvc 注 解 的 类 : 


package spittr.config; 
import org.springframework.context.annotation.Configuration; 
import org.springframework.web.servlet.config.annotation.EnableWebMvc; 


@Configuration 
@EnableWebMvc 

public class WebConfig { 
} 








这 可 以 运行 起 来 ， 它 的 确 能 够 启用 Spring MVC， 但 还 有 不 少 问题 要 解 
和 


。 没有 配置 视图 解析 器 。 如 果 这 样 的 话 ，Spring 默 认 会 使 
用 BeanNameView-Resolver， 这 个 视图 解析 器 会 查找 ID 与 视图 名 
称 匹 配 的 bean， 并 且 碍 找 的 bean 要 实现 View 接 口 ， 它 以 这 样 的 方式 
来 解析 视图 。 
。 没有 启用 组 件 扫 描 。 这 样 的 结果 就 是 ，Spring 只 能 找到 显 式 声明 在 
配置 类 中 的 控制 器 。 
。 这 样 配置 的 话 ，DispatcherServlet 会 映射 为 应 用 的 默认 Servlet， 
所 以 它 会 处 理 所 有 的 请 求 ， 包 括 对 静态 资源 的 请 求 ， 如 图 片 和 样式 
表 〈 在 大 多 数 情况 下 ， 这 可 能 并 不 是 你 想 要 的 效果 ) 。 
因此 ， 我 们 需要 在 NebConfig 这 个 最 小 的 Spring MVC 配 置 上 再 加 一 些 内 
容 ， 从 而 让 它 变 得 真正 有 用 。 如 下 程序 清单 中 的 NebConfig 解 决 了 上 面 
所 述 的 问题 。 


程序 清单 5.2 ”最 小 但 可 用 的 Spring MVC 配 置 








package spittr.config; 

import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.ComponentScan; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.web.servlet.ViewResolver; 

import org.springframework.web.servlet.config.annotation. 
DefaultServletHandlerConfigurer; 

import org.springframework.web.servlet.config.annotation.EnableWebMvc; 

import org.springframework.web.servlet.config.annotation. 
WebMvcConfigurerAdapter:; 

import org.springframework.web.servlet .view. 

InternalResourceVviewResolver; 


&@Configuration 
@EnableWebMvc 4 启用 Spring MVC 
&ComponentScan{"spitter.web") 4 启用 组 件 扫描 
public class WebConfig 
extends WebMvcConfigurerAdapter { 
GBeazn 


public ViewResolver viewResolver{) { 
InternalResourceViewResolver resolver = 


配置 JSP 视图 解析 器 


new InternalResourceViewResolver!(); 
resolver.setPrefix("/WEB-INF/views/"); 
resolver.setSuffix{(".jsp"); 
resolver.setExposeContextBeansAsAttributes (true); 
return resolver; 
} 
GOverriade 配置 静态 资源 的 处 理 
public void configureDefaultServletHandling! < 
DefaultServletHandlerConfigurer configurer) { 
configurer.enable{); 


} 
} 


在 程序 清单 5.2 中 第 一 件 需要 注意 的 事情 是 NebConfig 现 在 添加 了 
@Component -Scan 注解 ， 因 此 将 会 扫描 spitter.web 包 来 查找 组 件 。 稍 后 
你 就 会 看 到 ， 我 们 所 编写 的 控制 费 将 会 市 有 @Controller 注 解 ， 这 会 使 
Re 
王 何 的 控制 器 。 


接 下 来 ， 我 们 添加 了 一 个 ViewResolver bean。 更 具体 来 讲 ， 

是 Internal-ResourceViewResolver。 我 们 将 会 在 第 6 章 更 为 详细 地 
讨论 视图 解析 器 。 我 们 只 需要 知道 它 会 查找 JSP 文 件 ， 在 查找 的 时 候 ， 
它 会 在 视图 名 称 上 加 一 个 特定 的 前 级 和 后 级 (例如 ， 名 为 home 的 视图 将 
会 解析 为 /WEB-INF/views/home.jsp)。 











最 后 ， 新 的 WebConfig 类 还 扩展 了 WebMvcConfigurerAdapter 并 重 写 
了 其 configureDefaultServletHandling() 方 法 。 通 过 调 

用 DefaultServlet-HandlerConfigurer 的 enable() 方 法 ， 我 们 要 
求 DispatcherServlet 将 对 静态 资源 的 请 求 转发 到 Servlet 容 器 中 默认 的 


Servlet 上 ， 而 不 是 使 用 DispatcherSservlet 本 吴 来 处 理 此 类 请 求 。 


WebConfig 已 经 就 纤 ， 那 RootConfig 呢 ? 因为 本 章 聚 焦 于 Web 开 发 ， 
而 Web 相 关 的 配置 通过 DispatcherServlet 创 建 的 应 用 上 下 文 都 已 经 
配置 好 了 ， 因 此 现在 的 Rootconfig 相 对 很 简单 : 





package spittr.config; 


import org.springframework.context.annotation.ComponentScan; 

import org.springframework.context.annotation.ComponentScan.Filter; 
import org.springframework.context.annotation.Configuration; 

import org.springframework.context.annotation.FilterType; 

import org.springframework.web.servlet.config.annotation.EnableWebMvc; 


@Configuration 
@ComponentScan(basePackages={"spitter"}, 
excludeFilters={ 
@Filter(type=FilterType.ANNOTATION, value=EnableWebMvc.class) 


}) 
public class RootConfig { 





唯一 需要 注意 的 是 RootConfig 使 用 了 @ComponentScan 注 解 。 这 样 的 
话 ， 在 本 书 中 ， 我 们 就 有 很 多 机 会 用 非 Web 的 组 件 来 充实 完善 
RootConfig。 


现在 ， 我 们 基本 上 已 经 可 以 开始 使 用 Spring MVC 构 建 Web 应 用 了 。 此 
时 ， 最 大 的 问题 在 于 ， 我 们 要 构建 的 应 用 到 底 是 什么 。 


5.1.3 ”Spittr 应 用 简介 


为 了 实现 在 线 社交 的 功能 ， 我 们 将 要 构建 一 个 简单 的 微 博 
Cmicroblogging) 应 用 。 在 很 多 方面 ， 我 们 所 构建 的 应 用 与 最 早 的 微 博 
应 用 Twitter 很 类 似 。 在 这 个 过 程 中 ， 我 们 会 添加 一 些小 的 变化 。 当 然 ， 
我 们 要 使 用 Spring 技术 来 构建 这 个 应 用 。 


因为 从 Twitter 借鉴 了 灵感 并 且 通 过 Spring 来 进行 实现 ， 所 以 它 就 有 了 一 
个 名 字 : Spitter。 再 进一步 ， 应 用 网 站 命名 中 流行 的 模式 ， 如 Flickr， 我 
们 去 挥 字母 e:， 这 样 的 话 ， 我 们 就 将 这 个 应 用 称 为 Spittr。 这 个 名 称 也 有 
助 于 区 分 应 用 名 称 和 领域 类 型 ， 因 为 我 们 将 会 创建 一 个 名 为 Spitter 的 








Spittr 频 用 有 两 个 基本 的 领域 概念 : Spitter 〈 应 用 的 用 户 ) 和 Spittle〈 用 
户 发 布 的 简短 状态 更 新 ) 。 当 我 们 在 书 中 完善 Spittr 应 用 的 功能 时 ， 将 
会 介绍 这 两 个 领域 概念 。 在 本 章 中 ， 我 们 会 构建 应 用 的 Web 层 ， 创 建 展 
现 Spittle 的 控制 器 以 及 处 理 用 户 注册 成 为 Spitter 的 表单 。 


舞台 已 经 搭建 完成 了 。 我 们 已 经 配置 了 DispatcherServlet， 启 用 了 
基本 的 Spring MVC 组 件 并 确定 了 目标 应 用 。 让 我 们 进入 本 章 的 核心 内 
容 : 使 用 Spring MVC 控 制 器 处 理 Web 请 求 。 


5.2 ”编写 基本 的 控制 需 


在 Spring MVC 中 ， 控 制 器 只 是 方法 上 添加 了 @RequestMapping 注 解 的 
类 ， 这 个 注解 声明 了 它们 所 要 处 理 的 请 求 。 


开始 的 时 候 ， 我 们 尽 可 能 简单 ， 假 设 控制 器 类 要 处 理 对 “的 请 求 ， 并 演 
染 应 用 的 首页 。 程 序 清单 5.3 所 示 的 HomeController 可 能 是 最 简单 的 
Spring MVC 控 制 器 类 了 。 


程序 清单 5.3 ”HomeController: 超级 简单 的 控制 器 


package spittr.web; 

import static org.springframework.web.bind.annotation.RequestMethod.*; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 

import org.springframework.web.bind.annotation.RequestMethod; 


@Controller < 一 声明 为 一 个 控制 器 


public class HomeController { 


@RequestMapping (value="/", method=GET) 4 处 理 对 “/” 的 GET 请求 
public String home() { 
return "home"; < 一 视图 名 为 home 


} 
} 





你 可 能 注意 到 的 第 一 件 事 情 就 是 HomeController 带 有 @Controller 注 
解 。 很 显 然 这 个 注解 是 用 来 声明 控制 器 的 ， 但 实际 上 这 个 注解 对 Spring 
MVC 本 号 的 影响 并 不 大 。 


HomeController 是 一 个 构造 型 〈stereotype) 的 注解 ， 它 基于 
@Component 注 解 。 在 这 里 ， 它 的 目的 就 是 辅助 实现 组 件 扫 摘 。 

为 HomeController 带 有 @Controller 注 解 ， 因 此 组 件 扫描 器 会 自动 找 
到 HomeController， 并 将 其 声明 为 Spring 应 用 上 下 文中 的 一 个 bean。 


其 实 ， pn 它 所 实现 的 
效果 是 一 样 的 ， 但 是 在 表意 性 上 可 能 会 差 一 些 ， 无 法 确定 
HomeController 是 什么 组 件 类 型 。 





HomeController 唯 一 的 一 个 方法 ， 也 就 是 home() 方 法 ， 市 
有 @RequestMapping 注 解 。 它 的 value 属 性 指定 了 这 个 方法 所 要 处 理 的 
请 求 路 径 ，method 属 性 细 化 了 它 所 处 理 的 HTTP 方 法 。 在 本 例 中 ， 当 收 


到 对 “的 HITP GET 请 求 时 ， 就 会 调用 home () 方 法 。 


你 可 以 看 到 ，home() 方 法 其 实 并 没有 做 太 多 的 事情 : 它 返回 了 一 

个 String 类 型 的 “home”。 这 个 String 将 会 被 Spring MVC 解 读 为 要 演 染 
的 视图 名 称 。DispatcherServlet 会 要 求 视图 解析 器 将 这 个 逻辑 名 称 
解析 为 实际 的 视图 。 


鉴于 我 们 配置 InternalResourceViewResolver 的 方式 ， 视 图 
名 “home” 将 会 解析 为 “WEB-INF/viewshome.jsp2” 路 径 的 JSP。 现 在 ， 我 
们 会 让 Spittr 应 用 的 首页 相当 简单 ， 如 下 所 示 。 


程序 清单 5.4 ”Spittr 应 用 的 首页 ， 定 义 为 一 个 人 简单 的 JSP 


<%Q@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<X%Q@ page session="false" %> 
<html> 
<head> 
<title>Spittr</title> 
<link rel="stylesheet" 
type="text/css" 
href="<c:url value="/resources/style.css" />" > 
</head> 
<body> 
<hi>Welcome to Spittr</h1> 
<a href="<c:url value="/spittles" />">Spittles</a> | 
<a href="<c:url value="/spitter/register" />">Register</a> 
</body> 
</html> 














这 个 JSP 并 没有 太 多 需要 注意 的 地 方 。 它 只 是 欢迎 应 用 的 用 户 ， 并 提供 
了 两 个 链接 : 一 个 是 查看 Spittle 列 表 ， 男 一 个 是 在 应 用 中 进行 注册 。 
图 5.2 展 现 了 此 时 的 首页 是 什么 样子 的 。 


在 本 章 完 成 之 前 ， 我 们 将 会 实现 处 理 这 些 请 求 的 控制 器 方法 。 但 现在 ， 
让 我 们 对 这 个 控制 器 发 起 一 些 请 求 ， 看 一 下 它 是 否 能 够 正常 工作 。 测 试 
控制 二 最 直接 的 办 法 可 能 就 是 构建 并 部 晋 应 用 ， 然 后 通过 浏览 器 对 其 进 
行 访问 ， 但 是 目 动 化 测试 可 能 会 给 你 更 快 的 反馈 和 更 一 致 的 独立 结果 。 
所 以 ， 让 我 们 编写 一 个 针对 HomeController 的 测试 。 

















四 日 品 Spittr « 
i222| (9 localhost:8080 ¢ a 2 OO 


Welcome to Spittr 


Spities | Regisier 


图 5.2 ”当前 的 Spittr 首 页 
5.2.1 ”测试 控制 器 


让 我 们 再 审视 一 下 HomeController。 如 果 你 眼神 不 太 好 的 话 ， 你 甚至 
可 能 注意 不 到 这 些 注 解 ， 所 看 到 的 仅仅 是 一 个 简单 的 POJO。 我 们 都 知 
道 测试 POJO 是 很 容易 的 。 因 此 ， 我 们 可 以 编写 一 个 简单 的 类 来 测试 
HomeController， 如 下 所 示 : 


程序 清单 5.5 HomeControllerTest: 测试 HomeController 


package spittr.web; 

import static org.junit.Assert.assertEquals; 
import org.junit.Test; 

import spittr.web.HomeController; 


public class HomeControllerTest { 


@Test 
public void testHomePage() throws Exception { 
HomeController controller = new HomeController(); 
assertEquals("home", controller.home()); 
} 
} 





程序 清单 5.5 中 的 测试 很 简单 ， 但 它 只 测试 了 home( ) 方 法 中 会 发 生 什 
么 。 在 测试 中 会 直接 调用 home( ) 方 法 ， 并 断言 返回 包 售 “home” 值 的 


string。 它 完全 没有 站 在 Spring MVC 控 制 器 的 视角 进行 测试 。 这 个 测 
试 没 有 断言 当 接 收 到 针对 “/” 的 GET 请 求 时 会 调用 home() 方 法 。 因 为 它 返 
回 的 值 就 是 “home”， 所 以 也 没有 真正 判断 home 是 视图 的 名 称 。 


不 过 从 Spring 3.2 开 始 ， 我 们 可 以 按照 控制 占 的 方式 来 测试 Spring MVC 
中 的 控制 器 了 ， 而 不 仅仅 是 作为 POJO 进 行 测试 。Spring 现 在 包含 了 一 种 
mock Spring MVC 并 针对 控制 器 执行 HTTP 请 求 的 机 制 。 这 样 的 话 ， 在 测 
试 控制 器 的 时 候 ， 束 没有 必要 再 启动 Web 服 务 器 和 Web 浏 览 器 了 。 


为 了 阐述 如 何 测试 Spring MVC 的 控制 器 ， 我 们 重 写 
HomeControllerTest 并 使 用 Spring MVC 中 新 的 测试 特性 。 程 序 清 单 
5.6 展 现 了 新 的 HomeControllerTest。 





程序 清单 5.6 ”改进 HomeControllerTest 


Package spittr.web; 
import static 
org.springframework.test .web.servlet.regquest.MockMvcRequestBuilders.*; 
import static 
org.springframework.test.web.servlet.result.MockMvcResultMatchers.*; 
import static 
org.springframework.test .web,.servlet.setup.MockMvcBuilders.*; 
import org.junit.Test; 
import org.springframework .test. 7 .Servlet .MockMvce; 
import i er; 


public class HomeControllerTest { 
GTest 


public void testHomePage() throws Exception { 
HomeController controller = new HomeController(}; 
MockMvc mockMvc = < 一 搭建 MockMvce 
standaloneSetup{lcontroller) .build!(); 
wj 4 FT 潜入 
mockMvc .perform(get{"/")) Ee 对 “/” 执 行 GET 请 求 


.andExpect (view() .name ("home")); - 预期 得 到 home 视图 
} 
} 


尽管 新 版 本 的 测试 只 比 之 前 版 本 多 了 几 行 代码 ， 但 是 它 更 加 完整 地 测试 
了 HomeController。 这 次 我 们 个 是 直接 调用 home( ) 方 法 并 测试 它 的 返 
回 值 ， 而 是 发 起 了 对 “/” 的 GET 请 求 ， 并 断言 结果 视图 的 名 称 为 home。 它 
首先 传递 一 个 HomeController 实 例 

到 MockMvcBuilders.standaloneSetup() 并 调用 buil1d() 来 构建 
MockMvc 实 例 。 然 后 它 使 用 MockMvc 实 例 来 执行 针对 “的 GET 请 求 并 
设置 期 望 得 到 的 视图 名 称 。 


5.2.2 定义 类 级 别 的 请 求 处 理 














现在 ， 已 经 为 HomeController 编 号 了 测试 ， 那 么 我 们 可 以 做 一 些 重 
构 ， 并 通过 测试 来 保证 不 会 对 功能 造成 什么 破坏 。 我 们 可 以 做 的 一 件 事 
就 是 拆 分 9RequestMapping， 并 将 其 路 径 映 射 部 分 放 到 类 级 别 上 。 程 
序 清 单 5.7 展 示 了 这 个 过 程 。 


程序 清单 5.7 拆 分 HomeController 中 的 @RequestMapping 


package spittr.web; 

import static org.springframework .web.bind.annotation.RegquestMethod.*; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 


import org.springframework.web.bind.annotation.RequestMethod; 


Controller 
@RequestMapping("/") - 将 控制 器 映射 到 “/ 


public class HomeController { 


GeReauestMapping (method=GET) 4 处 理 GET 请 求 
public String home() { 
下 ~ > 
return "home"; < 视图 名 为 home 


在 这 个 新 版 本 的 HomeController 中 ， 路 径 现 在 被 转移 到 类 级 别 的 
Q@RequestMapping 上 ， 而 HITP 方 法 依然 映射 在 方法 级 别 上 。 当 控制 器 
在 类 级 别 上 添加 @RequestMapping 注 解 时 ， 这 个 注解 会 应 用 到 控制 费 
的 所 有 处 理 器 方法 上 。 处 理 器 方法 上 的 @RequestMapping 注 解 会 对 类 
级 别 上 的 @RequestMapping 的 声明 进行 补充 。 


就 HomeController 而 言 ， 这 里 只 有 一 个 控制 器 方法 。 与 类 级 别 的 
@Request-Mapping 合 并 之 后 ， 这 个 方法 的 @RequestMapping 表 
明 home( ) 将 会 处 理 对 “/” 路 径 的 GET 请 求 。 


换言之 ， 我 们 其 实 没 有 改变 任何 功能 ， 只 是 将 一 些 代 码 换 了 个 地 方 ， 但 
是 HomeController 所 做 的 事情 和 以 前 是 一 样 的 。 因 为 我 们 现在 有 了 测 
试 ， 所 以 可 以 确保 在 这 个 过 程 中 ， 没 有 对 原 有 的 功能 造成 破坏 。 


当 我 们 在 修改 @RequestMapping 时 ， 还 可 以 对 HomeController 做 另外 
一 个 变更 。@RequestMapping 的 value 属 性 能 够 接受 一 个 String 类 型 
的 数组 。 到 目前 为 止 ， 我 们 给 它 设置 的 都 是 一 个 String 类 型 的 “/”。 但 
是 ， 我 们 还 可 以 将 它 映射 到 对 “/homepage” 的 请 求 ， 只 需 将 类 级 别 的 
@RequestMapping 改 为 如 下 所 示 : 


@Controller 








@RequestMapping({"/", "/homepage"}) 
public class HomeController { 





现在 ，HomeController 的 home( ) 方 法 能 够 映射 到 
对 “/” 和 “/homepage” 的 GET 请 求 。 


5.2.3 ”传递 模型 数据 到 视图 中 


到 现在 为 止 ， 就 编写 超级 简单 的 控制 器 来 说 ，HomeController 已 经 是 
一 个 不 错 的 样 例 了 。 但 是 大 多 数 的 控制 器 并 不 是 这 么 简单 。 在 Spittr 访 
用 中 ， 我 们 需要 有 一 个 页 面 展 现 最 近 提 交 的 Spittle 列 表 。 因 此 ， 我 们 需 
要 一 个 新 的 方法 来 处 理 这 个 页 面 。 


首先 ， 需 要 定义 一 个 数据 访问 的 Repository。 为 了 实现 解 耘 以 及 避免 陷 

入 数据 库 访问 的 细节 之 中 ， 我 们 将 Repository 定 义 为 一 个 接口 ， 并 在 稍 
后 实现 它 (第 10 半 中) 。 此 时 ， 我 们 只 需要 一 个 能 够 获取 Spittle 列 表 的 
Repository， 如 下 所 示 的 SpittleRepository 功 能 已 经 足够 了 : 





package spittr.data; 
import java.util.List; 
import spittr.Spittle; 


public interface SpittleRepository { 
List<Spittle> findSpittles(long max, int count); 
} 


findSpittles() 方 法 接受 两 个 参数 。 其 中 max 参 数 代 表 所 返回 的 
Spittle 中 ，Spittle ID 属性 的 最 大 值 ， 而 count 参 数 表明 要 返回 多 少 
个 spittle 对 象 。 为 了 获得 最 新 的 20 个 spittle 对 象 ， 我 们 可 以 这 样 调 
用 findspittles(): 





List<Spittle> recent = 


spittleRepository.findSpittles(Long.MAX VALUE, 20); 





现在 ， 我 们 让 spittle 类 尺 可 能 的 人 简单， 如 下 面 的 程序 清单 5.8 所 示 。 它 
的 属性 包括 消 恩 内 容 、 时 间 戳 以 及 Spittle 发 布 时 对 应 的 经 纬度 。 


程序 清单 5.8 ”Spittle 类 : 包含 消 轧 内 容 、 时 间 惟 和 位 置信 息 





package spittr; 
import java.util.Date; 


public class Spittle { 
private final Long id; 
private final String message; 
private final Date time; 
private Double latitude; 
private Double longitude; 


public Spittle(String message, Date time) { 
this(message, time, null, null); 


} 


public Spittle( 
String message, Date time, Double longitude, Double latitude) { 
this.id = null; 
this.message = message; 
this.time = time; 
this.longitude = longitude; 
this.1latitude = latitude; 
} 


public long getId() { 
return id; 


} 


public String getMessage() { 
return message; 


} 


public Date getTime() { 
return time; 


} 


public Double getLongitude() { 
return longitude; 


} 


public Double getLatitude() { 
return latitude; 


} 


@Override 
public boolean equals(Object that) { 
return EqualsBuilder.reflectionEquals(this, that, "id", "time"); 


} 


@Override 
public int hashCode() { 
return HashCodeBuilder.reflectionHashCode(this, "id", "time"); 
} 
} 





就 大 部 分 内 容 来 看 ，Spittle 就 是 一 个 基本 的 POJO 数 据 对 象 一 一 没有 
什么 复杂 的 。 唯 一 要 注意 的 是 ， 我 们 使 用 Apache Common Lang 包 来 实 
现 equals() 和 hashCode() 方 法 。 这 些 方法 除了 常规 的 作用 以 外 ， 当 我 
们 为 控制 器 的 处 理 器 方法 编写 测试 时 ， 它 们 也 是 有 用 的 。 


既然 我 们 说 到 了 测试 ， 那 么 我 们 继续 讨论 这 个 话题 并 为 新 的 控制 需 方 法 
编写 测试 。 如 下 的 程序 清单 使 用 Spring 的 MockMvc 来 断言 新 的 处 理 器 方 
法 中 你 所 期 望 的 行为 。 


程序 清单 5.9 ”测试 SpittleController 处 理 针 对 “/spittles” 的 GET 请 求 


@Test 
public void shouldSshowRecentSpittles{() throws Exception { 
List<Spittle> expectedSpittles = createSpittleList(20); 
SpittleRepository mockRepository = <— Mock Repository 
mock{SpittleRepository.class); 
when (mockRepository.findSspittles (Long.MAX VALUE, 20)) 
.thenReturn (expectedSpittles); 


SpittleController controller = 
new SpittleController (mockRepository); 
MockMvc mockMvc = standaloneSetup{controller) < Mock Spring MVC 
.SetSingleView! 


new InternalResourceView("/WEB-INF/views/spittles.jsp")) 
.build(); 
mockMvc .perform(get("/spittles")) ; 对 “/spittles” 发 起 GET 请 求 
.andExpect (view() .name ("spittles") 


.andExpect (model () .attributeExists("spittleList")) 
.andExpect (model () .attribute("spittlebist", < 一 断言 期 望 的 值 
hasItems (expectedSpittles.toArray()))); 


private List<Spittle> createSpittleList(int count) { 
List<Spittle> spittles = new Arraybist<Spittle>(); 
for {int d= 2 & Count: A+ 疾 
spittles.add{new Spittle{("Spittle " + i, new Date())); 
return spittles; 


} 


这 个 测试 首先 会 创建 spittleRepository 接 口 的 mock 实 现 ， 这 个 实现 
会 从 它 的 findSpittles() 方 法 中 返回 20 个 spittle 对 象 。 然 后 ， 它 将 


这 个 Repository 注 入 到 一 个 新 的 SpittleController 实 例 中 ， 然 后 创 
建 MockMvc 并 使 用 这 个 控制 器 。 


需要 注意 的 是 ， 与 HomeController 不 同 ， 这 个 测试 在 MockMvc 构 造 器 
上 调用 了 setsingleView()。 这 样 的 话 ，mock 框 架 就 不 用 解析 控制 器 
中 的 视图 名 了 。 在 很 多 场景 中 ， 其 实 没 有 必要 这 样 做 。 但 是 对 于 这 个 控 
制 妖 方法 ， 视 图 名 与 请 求 路 径 是 非常 相似 的 ， 这 样 按 照 默 认 的 视图 解析 
规则 时 ，MockMvc 束 会 发 生 失 败 ， 因 为 无 法 区 分 视图 路 径 和 控制 器 的 路 
径 。 在 这 个 测试 中 ， 构 建 InternalResourceView 时 所 设置 的 实际 路 径 
是 无 关 紧 要 的 ， 但 我 们 将 其 设置 为 

与 InternalResourceViewResolver 配 置 一 致 。 


这 个 测试 对 “spittles” 发 起 GET 请 求 ， 然 后 断言 视图 的 名 称 为 spittles 并 且 
模型 中 包含 名 为 spittleList 的 属性 ， 在 spittleList 中 包含 预期 的 内 
和 


当然 ， 如 果 此 时 运行 测试 的 话 ， 它 将 会 失败 。 它 不 是 运行 失败 ， 而 是 在 
编译 的 时 候 就 会 失败 。 这 是 因为 我 们 还 没有 编写 
SpittleController。 现 在 ， 我 们 创建 spittleController， 让 它 满 
足 程序 清单 5.9 的 预期 。 如 下 的 SpittleController 实 现 将 会 满足 以 上 
测试 的 要 求 。 


程序 清单 5.10 ”SpittleController: 在 模型 中 放 入 最 新 的 spittle 列 表 








package spittr.web; 

import java.util.List:; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import spittr.Spittle; 

import spittr.data.SpittleRepository; 


@Controller 
&@RequestMapping("/spittles") 
public class SpittleController { 


private SpittleRepository spittleRepository:; 
&Autowired 
public SpittleController( < 一 注 人 人 SpittleRepository 
SpittleRepository spittleRepository) { 
this.spittleRepository = spittleRepository; 
} 
@RequestMapping (method=RequestMethod .GET) 


public String spittles(Model model) { 
model .addAttributel 
spittleRepository.findSspittles! 
Long .MAX_VALUE, 20)); 
return "spittles"; 本 返回 视图 名 
} 


将 spittle 添加 到 模型 中 


} 


我 们 可 以 看 到 SpittleController 有 一 个 构造 器 ， 这 个 构造 器 使 用 了 
@Autowired 注 解 ， 用 来 注入 SpittleRepository。 这 

个 spittleRepository 随 后 义 用 在 spittles() 方 法 中 ， 用 来 获取 最 新 
的 spittle 列 表 。 


需要 注意 的 是 ， 我 们 在 spittles() 方 法 中 给 定 了 一 个 Model 作 为 参 
数 。 这 样 ，spittles() 方 法 焉 能 将 Repository 中 获取 到 的 Spittle 列 
表 填 充 到 模型 中 。Mode1 实 际 上 就 是 一 个 Map〈 也 就 是 key-value 对 的 集 
合 ) ， 它 会 传递 给 视图 ， 这 样 数据 就 能 泻 染 到 客户 端 了 。 当 调 

用 addAttribute() 方 法 并 且 不 指定 key 的 时 候 ， 那 么 key 会 根据 值 的 对 
象 类 型 推断 确定 。 在 本 例 中 ， 因 为 它 是 一 个 List<Spittle>， 因 此 ， 键 
将 会 推 新 为 spittleList。 


spittles() 方 法 所 做 的 最 后 一 件 事 是 返回 spittles 作 为 视图 的 名 他， 
这 个 视图 会 泻 染 模型 。 


如 果 你 希望 显 式 声明 模型 的 key 的 话 ， 那 也 尽 可 以 进行 指定 。 例 如 ， 下 
0 














@RequestMapping(method=RequestMethod .GET) 
public String spittles(Model model) { 
model.addAttribute("spittleList", 


spittleRepository.findSpittles(Long.MAX VALUE, 20)); 
return "spittles"; 


} 





如 果 你 希望 使 用 非 Spring 类 型 的 话 ， 那 么 可 以 用 java.util.Map 来 代 蔡 
下 面 这 个 版 本 的 spittles() 方 法 与 之 前 的 版 本 在 功能 上 是 一 
冯 的 ， 


@RequestMapping(method=RequestMethod .GET) 
public String spittles(Map model) { 
model.put("spittleList", 
spittleRepository.findSpittles(Long.MAX VALUE, 20)); 
return "spittles"; 


} 








既然 我 们 现在 提 到 了 各 种 可 荐 代 的 方案 ， 那 下 面 还 有 另外 一 种 方式 来 编 
写 spittles() 方 法 : 


@RequestMapping(method=RequestMethod .GET) 
public List<Spittle> spittles() { 


return spittleRepository.findSpittles(Long.MAX VALUE, 20)); 
} 





这 个 版 本 与 其 他 的 版 本 有 些 差别 。 它 并 没有 返回 视图 名 称 ， 也 没有 显 式 
地 设 定 模型 ， 这 个 方法 返回 的 是 Spittle 列 表 。 当 处理 器 方法 像 这 样 返 
回 对 象 或 集合 时 ， 这 个 值 会 放 到 模型 中 ， 模 型 的 key 会 根据 其 类 型 推断 
得 出 (在 本 例 中 ， 也 就 是 spittleList) 。 


而 逻辑 视图 的 名 称 将 会 根据 请 求 路 径 推 项 得 出 。 因 为 这 个 方法 处 理 针 
对 “/spittles” 的 GET 请 求 ， 因 此 视图 的 名 称 将 会 是 spittles (去掉 开 头 的 
斜 线 ) 。 


不 管 你 选择 哪 种 方式 来 编写 spittles() 方 法 ， 所 达成 的 结果 都 是 相同 

的 。 模 型 中 会 存储 一 个 Spittle 列 表 ，key 为 spittleList， 然 后 这 个 

列表 会 发 送 到 名 为 spittles 的 视图 中 。 按 照 我 们 配 

置 InternalResourceViewResolver 的 方式 ， 视 图 的 JSP 将 会 是 “/WEB- 
INF/views/spittles.jsp”。 





现在 ， 数 据 已 经 放 到 了 模型 中 ， 在 JSP 中 该 如 何 访问 它 呢 ? 实际 上 ， 当 
视图 是 JSP 的 时 候 ， 模 型 数据 会 作为 请 求 属性 放 到 请 求 (request) 之 
中 。 因 此 ， 在 spittles.jsp 文 件 中 可 以 使 用 JSTL (JavaServer Pages Standard 
Tag Library) 的 <c:forEach> 标 签 泻 染 spittle 列 表 


<C:forEach items="${spittleList}" var="spittle" > 
<l1i id="spittle <c:out value="spittle.id"/>"> 
<div class="spittleMessage"> 
<c:out value="${spittle.message}" /> 
</div> 
<div> 


<Span class="spittleTime"><c:out value="${spittle.time}" /></span> 
<span class="spittleLocation"> 
(<c:out value="${spittle.latitude}" />, 
<c:out value="${spittle.longitude}" />)</span> 
</div> 
</1i> 
</c:forEach> 





能 够 让 你 对 它 在 Web 浏 览 右 中 是 什么 样子 有 个 可 视 化 
和 印象 。 


尽管 spittleController 很 简单 ， 但 是 它 依然 比 HomeController 更 进 
= 不 过 ， spittleController 和 HomeController 都 没有 处 理 任 
何 形式 的 输入 。 现 在 ， 让 我 们 扩展 SpittleController， 让 它 从 客户 
端 接受 一 些 输 入 。 


全曲 Spittr 
Im) @ localhost:8080 C Reades leds Sj 


Recent Spittles 


» Spities go fourth! 
2013-09-02 (0.0, 00) 
es Spitie 0 pi 
2013-09-02 {0 
es Here's a spittie 
2013-09-02 (0.0, 0.0) 
es Hello world! The first ever spittie! 
2013-09-02 {0.0, 0.0) 








图 5.3 ”控制 器 中 的 Spitue 模 型 数据 将 会 作为 请 求 参数 ， 并 在 web 页 面 上 泻 染 为 列表 的 形式 





5.3 ”接受 请 求 的 输入 


有 些 Web 应 用 是 只 读 的 。 人 们 只 能 通过 浏览 器 在 站 点 上 闲逛 ， 阅 读 服 务 
器 发 送 到 浏览 器 中 的 内 容 。 


不 过 ， 这 并 不 是 一 成 不 变 的 。 众 多 的 Web 应 用 人 允许 用 户 参 与 进去 ， 将 数 
3 如 果 没 有 这 项 能 力 的 话 ， 那 Web 将 完全 是 力 一 看 景 











人 允许 以 多 种 方式 将 客户 端 中 的 数据 传送 到 控制 右 的 处 理 器 方 
> 


。 查询 参数 (Query Parameter) 。 
。 表单 参数 (Form Parameter) 。 
。 路 径 变 量 (Path Variable) 。 


你 将 会 看 到 如 何 编写 控制 右 处 理 这 些 不 同 机 制 的 输入 。 作 为 开始 ， 我 们 
先 看 一 下 如 何 处 理 带 有 查询 参数 的 请 求 ， 这 也 是 客户 站 往 服务 妖 病 太 送 
数据 时 ， 最 简单 和 最 直接 的 方式 。 


5.3.1 “处理 查询 参数 


在 Spittr 应 用 中 ， 我 们 可 能 需要 处 理 的 一 件 事 就 是 展现 分 页 的 Spittle 列 
表 。 在 现在 的 SpittleController 中 ， 它 只 能 展现 最 新 的 Spitte， 并 没 
有 办 法 向 前 翻 页 查看 以 前 编写 的 Spittle 历 史记 录 。 如 果 你 想 让 用 户 每 次 
都 能 得 看 某 一 页 的 Spittle 历 史 ， 那 么 就 需要 提供 一 种 方式 让 用 户 传递 参 
数 进来 ， 进 而 确定 要 展现 哪些 Spittle 集 合 。 


在 确定 该 如 何 实现 时 ， 假 设 我 们 要 查看 某 一 页 Spittle 列 表 ， 这 个 列表 会 
按照 最 新 的 Spittle 在 前 的 方式 进行 排序 。 因 此 ， 下 一 页 中 第 一 条 的 ID 肯 
定 会 早 于 当前 页 最 后 一 条 的 ID。 所 以 ， 为 了 显示 下 一 页 的 Spittle， 我 们 
需要 将 一 个 Spittle 的 ID 传 入 进来 ， 这 个 ID 要 恰好 小 于 当前 页 最 后 一 
Spittle 的 ID。 男 外 ， 你 还 可 以 传 入 一 个 参数 来 确定 要 展现 的 Spittle 数 


上 用. 
里 。 


为 了 实现 这 个 分 页 的 功能 ， 我 们 所 编写 的 处 理 需 方法 要 接受 如 下 的 参 




















数 : 


。 before 参 数 〈 表 明 结 果 中 所 有 Spittle 的 ID 均 应 该 在 这 个 值 之 
前 ) 。 
。 Count 参数 〈 表 明 在 结果 中 要 包含 的 Spittle 数 量 ) 。 
为 了 实现 这 个 功能 ， 我 们 将 程序 清单 5.10 中 的 spittles() 方 法 蔡 换 为 
使 用 before 和 count 参 数 的 新 spittles() 方 法 。 我 们 首先 添加 一 个 测 
试 ， 这 个 测试 反映 了 新 spittles() 方 法 的 功能 。 


程序 清单 5.11 用 来 测试 分 页 Spittle 列 表 的 新 方法 


@Test 
public void shouldShowPagedSpittles () throws Exception { 
List<Spittle> expectedSpittles = createSpittleList(50); 


SpittleRepository mockRepository = mock(SpittleRepository.class); 
when {mockRepository.findSspittles(238900, 50)) 1 EE i 
i 1 期 的 max ount 全 
.thenReturn(lexpectedSspittles); 预期 的 max 和 count 数 
SpittleController controller = 

new SpittleController (mockRepository); 


MockMvc mockMvc = standaloneSetup(controller) 
.SetSingleView( 
new InternalResourceView!("/WEB-INF/views/spittles.jsp")) 
.build!(); 
mockMve.performlget ("/spittles?max=238900&count=50")) 4 传 入 max 和 
"andExpect (view(} name("spittles")) | count 参数 
.andExpect (model () .attributeExists("spittleList")) 
.andExpect (model () .attribute{"spittleList", 


hasIitems (expectedSspittles.toArray()))); 
} 


这 个 测试 方法 与 程序 清单 5.9 中 的 测试 方法 关键 区 别 在 于 它 针 

对 “/spittles” 发 送 GET 请 求 ， 同 时 还 传 入 了 max 和 count 参 数 。 它 测试 了 这 
些 参数 存在 时 的 处 理 器 方法 ， 而 另 一 个 测试 方法 则 测试 了 没有 这 些 参 数 
时 的 情景 。 这 两 个 测试 就 绪 后 ， 我 们 就 能 确保 不 管控 制 器 发 生 什么 样 的 
变化 ， 它 都 能 够 处 理 这 两 种 类 型 的 请 求 : 





@RequestMapping(method=RequestMethod .GET) 
public List<Spittle> spittles( 
@Requestparam("max") long max, 


@RequestPparam("count") int count) { 
return spittleRepository.findSpittles(max, count); 


} 


SpittleController 中 的 处 理 器 方法 要 同时 处 理 有 参数 和 没有 参数 的 
场景 ， 那 我 们 需要 对 其 进行 修改 ， 让 它 能 接受 参数 ， 同 时 ， 如 果 这 些 参 





数 在 请 求 中 不 存在 的 话 ， 就 使 用 默认 值 Long.MAX_VALUE 和 
20。@RequestParam 注 解 的 defaultValue 属 性 可 以 完成 这 项 任务 : 


@RequestMapping(method=RequestMethod .GET) 
public List<Spittle> spittles( 
@Requestparam(value="max", 


defaultValue=MAX_ LONG AS_ STRING) long max, 
@Requestparam(value="count", defaultValue="286") int count) { 
return spittleRepository.findSpittles(max, count); 


} 


现在 ， 如 果 max 参 数 没 有 指定 的 话 ， 它 将 会 是 Long 类 型 的 最 大 值 。 因 为 
查询 参数 都 是 String 类 型 的 ， 因 此 defaultValue 属 性 需要 string 类 型 
的 值 。 因 此 ， 使 用 Long .MAX_VALUE 是 不 行 的 。 我 们 可 以 

将 Long .MAX_VALUE 转 换 为 名 为 MAX_LONG_ -AS_STRING 的 String 类 型 常 
里 : 





private static final String MAX LONG AS_ STRING = 





Long.tostring(Long.MAX_VALUE ) ; 





尽管 defaultValue 属 性 给 定 的 是 String 类 型 的 值 ， 但 是 当 绑 定 到 方法 
的 max 人 参数 时 ， 它 会 转换 为 Long 类 型 。 


如 果 请 求 中 没有 count 参 数 的 话 ，count 参 数 的 默认 值 将 会 设置 为 20。 


请 求 中 的 查询 参数 是 往 控 制 咒 中 传递 信息 的 利用 手段 。 另 外 一 种 方式 也 
很 流行 ， 尤 其 是 在 构建 面向 资源 的 控制 器 时 ， 这 种 方式 就 是 将 传递 参数 
作为 请 求 路 径 的 一 部 分 。 让 我 们 看 一 下 如 何 将 路 径 变 量 作 为 请 求 路 径 的 
一 部 分 ， 从 而 实现 信息 的 输入 。 


5.3.2 ”通过 路 径 参 数 接受 输入 
假设 我 们 的 应 用 程序 需要 根据 给 定 的 ID 来 展现 某 一 个 Spittle 记 录 。 其 


中 一 种 方案 就 是 编写 处 理 器 方法 ， 通 过 使 用 @RequestParam 注 解 ， 让 它 
接受 ID 作 为 但 询 参 数 : 























@RequestMapping(value="/show", method=RequestMethod.GET) 
public String showSpittle( 

@Requestparam("spittle id") long spittleId， 

Model model) { 


model.addAttribute(spittleRepository.findOne(spittleld)); 
return "spittle"; 


} 





这 个 处 理 器 方法 将 会 处 理 形 如 “/spittles/show?spittle_id=12345” 这 样 的 请 
求 。 尽 管 这 也 可 以 正常 工作 ， 但 是 从 面向 资源 的 角度 来 看 这 并 不 理想 。 
在 理想 情况 下 ， 要 识别 的 资源 (Spittle) 应 该 通过 URL 路 径 进行 标 
示 ， 而 不 是 通过 查询 参数 。 对 “/spittles/12345” 发 起 GET 请 求 要 优 于 

对 “/spittles/show?spittle_id=12345” 发 起 请 求 。 前 者 能 够 识别 出 要 人 查询 的 
而 后 者 描述 的 是 融 有 参数 的 一 个 操作 一 一 本 质 上 是 通过 HTTP 友 
的 RPC。 





既然 已 经 以 面向 资源 的 控制 器 作为 目标 ， 那 我 们 将 这 个 需求 转换 为 一 个 
测试 。 程 序 清 单 5.12 展 现 了 一 个 新 的 测试 方法 ， 它 会 断 
言 SpittleController 中 对 面向 资源 ”请求 的 处 理 。 


程序 清单 5.12 测试 对 菏 个 Spittle 的 请 求 ， 其 中 ID 要 在 路 径 变 量 中 指定 


@Test 
public void testSpittle() throws Exception { 
Spittle expectedSspittle = 
SpittleRepo 


new Spittle("Hello", new Date()); 







ory mockRer itory = mock(SpittleRepository.class); 


when (mockRepository.findone(12345)) .thenReturn (expectedSpittle); 
SpittleController controller = new SpittleController (mockRepository); 
MockMvc mockMvc = standaloneSetup{lcontroller) .build!(); 
mockMvc .perform{lget("/spittles/12345")) < PE 
和 A 人 通过 路 径 请 求 资源 
.andExpect (view() .name ("spittle")) 
.andExpect (model () .attributeExists("spittle") 
.andExpect (model () .attribute("spittle", expectedSpittle)); 


可 以 看 到 ， 这 个 测试 构建 了 一 个 mock Repository、 一 个 控制 器 和 
MockMvc， 这 与 本 章 中 我 们 所 编写 的 其 他 测试 很 类 似 。 这 个 测试 中 最 重 
要 的 部 分 是 最 后 几 行 ， 它 对 “/spittles/12345” 发 起 GET 请 求 ， 然 后 断言 视 
图 的 名 称 是 spittle， 并 且 预 期 的 Spittle 对 象 放 到 了 模型 之 中 。 因 为 
我 们 还 没有 为 这 种 请 求实 现 处 理 器 方法 ， 因 此 这 个 请 求 将 会 失败 。 但 
是 ， 我 们 可 以 通过 为 spittleController 添 加 新 的 方法 来 修正 这 个 失 
败 的 测试 。 


到 目前 为 止 ， 在 我 们 编写 的 控制 器 中 ， 所 有 的 方法 都 映射 到 了 〈 通 过 
@RequestMapping) 静态 定义 好 的 路 径 上 。 但 是 ， 如 果 想 让 这 个 测试 
通过 的 话 ， 我 们 编写 的 @RequestMapping 要 包含 变量 部 分 ， 这 部 分 代 





表 了 Spittle ID。 


为 了 实现 这 种 路 径 变 量 ，Spring MVC 人 允许 我 们 在 @RequestMapping 路 
径 中 添加 占 位 符 。 占 位 符 的 名 称 要 用 大 括号 (“{” 和 “}”) 插 起 来 。 路 径 
和 的 请 求 完 全 匹配 ， 但 是 占 位 符 部 分 可 以 是 任意 
4 值 。 


下 面 的 处 理 旨 方法 使 用 了 占 位 符 ， 将 Spittle ID 作为 路 径 的 一 部 分 : 





@RequestMapping(value="/{spittleId}", method=RequestMethod .GET) 
public String spittle( 

@PathVariable("spittleId") long spittleId， 

Model model) { 


mode1.addAttribute(spittleRepository.findone(spittleId) ); 
return "spittle"; 


} 





例如 ， 它 就 能 够 处 理 针对 “/spittles/12345” 的 请 求 ， 也 就 是 程序 清单 5.12 
中 的 路 径 


我 们 可 以 看 到 ，spittle() 方 法 的 spitt1leId 参 数 上 添加 了 
@PathVvariable("spittleId") 注 解 ， 这 表明 在 请 求 路 径 中 ， 不 管 占 
位 符 部 分 的 值 是 什么 都 会 传递 到 处 理 器 方法 的 spittleId 参 数 中 。 如 果 
对 “/spittles/54321” 发 送 GET 请 求 ， 那 么 将 会 把 “54321” 传 递 进来 ， 作 

为 spittleId 的 值 。 


需要 注意 的 是 : 在 样 例 中 spittleId 这 个 词 出 现 了 好 几 次 : 先是 

在 @RequestMapping 的 路 径 中 ， 然 后 作为 @PathVariable 属 性 的 值 ， 
最 后 义 作 为 方法 的 参数 名 称 。 因 为 方法 的 参数 名 碰巧 与 占 位 符 的 名 称 相 
同 ， 因 此 我 们 可 以 去 掉 @Pathvariable 中 的 value 属 性 : 





@RequestMapping(value="/{spittleId}", method=RequestMethod .GET) 
public String spittle(@PathVariable long spittlelId, Model model) { 


model.addAttribute(spittleRepository.findOne(spittlelId)); 
return "spittle"; 


} 





如 果 @PathVariable 中 没有 value 属 性 的 话 ， 它 会 假设 占 位 符 的 名 称 与 
方法 的 参数 名 相同 。 这 能 够 让 代码 稍微 简洁 一 些 ， 因 为 不 必 重 复写 占 位 
符 的 名 称 了 。 但 需要 注意 的 是 ， 如 果 你 想 要 重 命 名 参数 时 ， 必 须要 同时 





修改 占 位 符 的 名 称 ， 使 其 互相 匹配 。 


spittle() 方 法 会 将 参数 传递 到 SpittleRepository 的 findone() 方 
法 中 ， 用 来 获取 某 个 spittle 对 象 ， 然 后 将 Spittle 对 象 添 加 到 模型 
中 。 模 型 的 key 将 会 是 spittle， 这 是 根据 传递 到 addAttribute() 方 法 
中 的 类 型 推断 得 到 的 。 


这 样 Spittle 对 象 中 的 数据 就 可 以 泻 染 到 视图 中 了 ， 此 时 需要 引用 请 求 
中 key 为 spittle 的 属性 〈 与 模型 的 key 一 致 ) 。 如 下 为 泻 染 Spittle 的 
JSP 视 图 片段 : 

<div class="spittleView"> 


<div class="spittleMessage"><c:out value="${spittle.message}" /></div> 
<div> 


<span class="spittleTime"><c:out value="${spittle.time}" /></span> 
</div> 
</div> 





这 个 视图 并 没有 什么 特别 之 处 ， 它 的 屏幕 截图 如 图 5.4 所 示 。 


和 日 日 Spittr 
12 | localhost:8080 © ||<,» OO 


| 
Hello worldl The first ever spittle! 
2013-09-02 


图 5.4 在 浏览 器 中 展现 一 个 spittle 
如 果 传 递 请 求 中 少量 的 数据 ， 那 查询 参数 和 路 径 变 量 是 很 合适 的 。 但 通 


常 我 们 还 需要 传递 很 多 的 数据 (也许 是 表 蛙 提交 的 数据 》 ， 那 查询 参数 
显得 有 些 符 拙 和 受 限 了 。 下 面 让 我 们 来 看 一 下 如 何 编写 控制 融 方 法 来 处 








理 表单 提交 。 


5.4 处理 表单 


Web 应 用 的 功能 通常 并 不 局 限于 为 用 户 推 送 内 容 。 大 多 数 的 应 用 允许 用 
户 填充 表单 并 将 数据 提交 回应 用 中 ， 通 过 这 种 方式 实现 与 用 户 的 交互 。 
像 提供 内 容 一 样 ， Spring MVC 的 控制 器 也 为 表单 处 理 提 供 了 民 好 的 文 


持 。 


使 用 表单 分 为 两 个 方面 : 展现 表单 以 及 处 理 用 户 通过 表单 提交 的 数据 。 
在 Spittr 应 用 中 ， 我 们 需要 有 个 表单 让 新 用 户 进行 注 

册 。SpitterController 是 一 个 新 的 控制 器 ， 目 前 只 有 一 个 请 求 处 理 
的 方法 来 展现 注册 表单 。 


程序 清单 5.13 ”SpitterController: 展现 一 个 表单 ， 人 允许 用 户 注 册 该 应 
用 


package spittr .web; 

import static org.springframework.web.bind.annotation.RequestMethod.*; 
import org.springframework.beans.factory.annotation.Autowired; 

import org,.springframework.stereotype.Controller; 





import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import spittr.Spitter; 

import spittr.data.SpitterRepository; 


@Controller 
@RequestMapping("/spitter") 


public class SpitterController { 





处 理 对 “/spitter/register” 


pu ¢ wR ) 人 vs i 
return "registerForm"; 的 GET 请 求 


} 


showRegistrationForm() 方 法 的 @RequestMapping 注 解 以 及 类 级 别 
上 的 @RequestMapping 注 解 组 合 起 来 ， 声 明了 这 个 方法 要 处 理 的 是 针 
对 “/spitter/register” 的 GET 请 求 。 这 是 一 个 简单 的 方法 ， 没 有 任何 输入 并 
且 只 是 返回 名 为 registerForm 的 逻辑 视图 。 按 照 我 们 配 

置 InternalResourceViewResolver 的 方式 ， 这 意味 着 将 会 使 

用 “/WEB-INF/ views/registerForm.jsp” 这 个 JSP 来 演 染 注册 表单 。 


尽管 showRegistrationForm() 方 法 非常 简单 ， 但 测试 依然 需要 徐 新 到 
它 。 因 为 这 个 方法 很 简单 ， 所 以 它 的 测试 也 比较 简单 。 





程序 清单 5.14 测试 展现 表单 的 控制 器 方法 


@Test 
public void shouldShowRegistration() throws Exception { 
SpitterController controller = new SpitterController(}); 
MockMvc mockMvc = standaloneSetup(controller) .build!{(); 构建 MockMvec 
mockMvc .perform(get("/spitter/register")) 
.andExpect (view!{) .name ("registerForm")); 断言 registerForm 视图 








这 个 测试 方法 与 首页 控制 器 的 测试 非常 类 似 。 它 对 “spitterregister” 用 
送 GET 请 求 ， 然 后 断言 结果 的 视图 名 为 registerForm。 


现在 ， 让 我 们 回 到 视图 上 。 因 为 视图 的 名 称 为 registerForm， 所 以 JSP 
的 名 称 需 要 是 registerForm.jsp。 这 个 JSP 必 须要 包含 一 个 HTML <form> 
标签 ， 在 这 个 标签 中 用 户 输 入 注册 应 用 的 信息 。 如 下 就 是 我 们 现在 所 要 
使 用 的 JSP。 


程序 清单 5.15 ” 演 染 注册 表单 的 JSP 


<%Q@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<X%Q@ page session="false" %> 
<html> 
<head> 
<title>Spittr</title> 
<link rel="stylesheet" type="text/css" 
href="<c:url value="/resources/style.css" />" > 
</head> 
<body> 
<hi>Register</h1> 
<form method="POST"> 
First Name: <input type="text" name="firstName" /><br/> 
Last Name: 《<input type="text" name="lastName" /><br/> 
Username: <input type="text" name="Uusername" /><br/> 
Password: “input type="password" name="password" /><br/> 
<input type="submit" value="Register" /> 
</form> 
</body> 
</html> 








可 以 看 到 ， 这 个 JSP 非 常 基础 。 它 的 HTML 表 单 域 中 记录 用 户 的 名 字 、 
姓氏 、 用 户 名 以 及 密码 ， 然 后 还 包含 一 个 提交 表单 的 按钮 。 在 浏览 器 泻 
染 之 后 ， 它 的 样子 大 致 如 图 5.5 所 示 。 





需要 注意 的 是 : 这 里 的 <form> 标 签 中 并 没有 设置 action 必 性。 在 这 种 
情况 下 ， 当 表单 提交 时 ， 它 会 提交 到 与 展现 时 相同 的 UREL 路 径 上 。 也 就 


是 说 ， 它 会 提交 到 “spitterregister” 上 。 








这 就 意味 着 需要 在 服务 器 端 处 理 该 HTTP POST 请 求 。 现 在 ， 我 们 

在 Spitter-Controller 中 再 添加 一 个 方法 来 处 理 这 个 表单 提交 。 
WL 3 localhost | 二 - ms 一 一 - 二 ny 6 | 
|Register 


| First Name: jack 
| Last Name: gauer 





Username: jbauey 
| Password: sores 
Register 








图 5.5 ”注册 页 提供 了 一 个 表单 ， 这 个 表单 会 由 SpitterController 
进行 处 理 ， 完 成 为 应 用 添加 新 用 户 的 功能 

















5.4.1 编写 处 理 表 单 的 控制 器 


当 处 理 注册 表单 的 POST 请 求 时 ， 控 制 器 需要 接受 表单 数据 并 将 表单 数据 
保存 为 Spitter 对 象 。 最 后 ， 为 了 防止 重复 提交 (用 户 点 击 浏览 器 的 刷 
新 按钮 有 可 能 会 发 生 这 种 情况 ) ， 应 该 将 浏览 器 重 定向 到 新 创建 用 户 的 
基本 信息 页 面 。 这 些 行为 通过 下 面 的 shouldProcessRegistration() 
进行 了 测试 。 


程序 清单 5.16 测试 处 理 表 单 的 控制 器 方法 





@Test 


public void shouldProcessRegistration() throws Exception { 

SpitterRepository mockRepository = 

mock (SpitterRepository.class); 4 构建 Repository 
Spitter unsaved = 

new Spitter("jbauer", "24hours", "Jack", "Bauer"); 
Spitter saved = 

new Spitter(24L,;, "jbauer", "24hours", "Jack", "Bauer"); 
when (mockRepository.save(unsaved)) .thenReturn (saved); 


SpitterController controller = 
new SpitterController{mockRepository); 


MockMvc mockMvc = standaloneSetuplcontroller) .build!(); + 构建 MockMve 
mockMvc .perform{(lpost("/spitter/register") 4 执行 请 求 
.param(l"firstName", "Jack") 
.param(l"lastName", "Bauer") 
.paraml"uUusername", "jbauer") 
.Param(l"password", "24hours")) 


.andExpect (redirectedUrl("/spitter/jbauer")); 


verify (mockRepository, atLeastonce()).save{lunsaved); < 一 校 验 保存 情况 
} 


显然 ， 这 个 测试 比 展现 注册 表单 的 测试 复杂 得 多 。 在 构建 完 
SpitterRepository 的 mock 实 现 以 及 所 要 执行 的 控制 器 和 MockMvc 之 
后 ，shouldProcess-Registration() 对 “/spitter/ register” 发 起 了 一 
个 POST 请 求 。 作 为 请 求 的 一 部 分 ， 用 户 信息 以 参数 的 形式 放 到 request 
中 ， 从 而 模拟 提交 的 表单 。 


在 处 理 POST 类 型 的 请 求 时 ， 在 请 求 处 理 完成 后 ， 最 好 进行 一 下 重 定 问 ， 
这 样 浏览 器 的 刷新 就 不 会 重复 提交 表单 了 。 在 这 个 测试 中 ， 预期 请 求 会 
重 定 同 到 ”spittevjbauer”， 也 就 是 新 建 用 户 的 基本 信息 页 面 。 


最 后 ， 测 试 会 校 验 SpitterRepository 的 mock 实 现 最 终 会 真正 用 来 保 
存 表单 上 传 入 的 数据 。 


现在 ， 我 们 来 实现 处 理 表 单 提交 的 控制 器 方法 。 通 过 shouldProcess- 
Registration() 方 法 ， 我 们 可 能 认为 要 满足 这 个 需求 需要 做 很 多 的 工 
作 。 但 是 ， 在 如 下 的 程序 清单 中 ， 我 们 可 以 看 到 新 的 
SpitterController 并 没有 做 太 多 的 事情 。 


程序 清单 5.17 处 理 所 提交 的 表单 并 注册 新 用 户 




















package SDittr.web; 
import static org.springframework.web.bind.annotation.RequestMethod.*; 


import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping; 
import spittr.Spitter; 

import spittr.data.SpitterRepository; 


@Controller 
8@RequestMapping("/spitter") 
public class SpitterController { 
private SpitterRepository spitterRepository; 


@Autowired 


public SpitterController!( 4 注入 SpitterRepository 
SpitterRepository spitterRepository) { 
this.spitterRepository = spitterRepository; 
} 


@RequestMapping (value="/register", method=GET} 
public String showRegistrationForm{) { 
return "registerForm"; 


} 

@RequestMapping (value="/register", method=POST) 

public String processRegistration(Spitter spitter) { 
spitterRepository.save{lspitter); < 保存 Spitter 
return "redirect:/spitter/" + 4 重 定 向 到 基本 信息 页 


spitter.getUsername():; 
} 
} 


我 们 之 前 创建 的 showRegistrationForm() 方 法 依然 还 在 ， 不 过 请 注意 
新 创建 的 processRegistration() 方 法 ， 它 接受 一 个 spitter 对 象 作 
为 参数 。 这 个 对 象 有 firstName、1astName、username 和 password 属 
性 ， 这 些 属性 将 会 使 用 请 求 中 同名 的 参数 进行 填充 。 


当 使 用 spitter 对 象 调用 processRegistration() 方 法 时 ， 它 会 进而 
调用 spitterRepository 的 save() 方 法 ，SpitterRepository 是 
在 Spitter-Controller 的 构造 器 中 注入 进来 的 。 


processRegistration() 方 法 做 的 最 后 一 件 事 就 是 返回 一 个 String 类 
型 ， 用 来 指定 视图 。 但 是 这 个 视图 格式 和 以 前 我 们 所 看 到 的 视图 有 所 不 
同 。 这 里 不 仅 返 回 了 视图 的 名 称 供 视 图 解析 器 查找 目标 视图 ， 而 且 返 回 
的 值 还 带 有 重 定向 的 格式 。 


当 InternalResourceViewResolver 看 到 视图 格式 中 的 “redirect:” 前 绥 
时 ， 它 就 知道 要 将 其 解析 为 重 定 同 的 规则 ， 而 不 是 视图 的 名 称 。 在 本 例 
中 ， 它 将 会 重 定 同 到 用 户 基 本 信息 的 页 面 。 例 如 ， 如 果 




















Spitter.username 属 性 的 值 为 “jbauer”， 那 么 视图 将 会 重 定 问 
El‘/spitter/jbauer”。 


需要 注意 的 是 ， 除 

了 “redirect:”，InternalResourceViewResolver 还 能 识 

别 “forward:” 前 级 。 当 它 发 现 视图 格式 中 以 “forward:” 作 为 前 级 时 ， 
请 求 将 会 前 往 (forward) 指定 的 UREL 路 径 ， 而 不 再 是 重 定 同 。 


万 事 俱 备 ! 现在 ， 程 序 清单 5.16 中 的 测试 应 该 能 够 通过 了 。 但 是 ， 我 们 
的 任务 还 没有 完成 ， 因 为 我 们 重 定向 到 了 用 户 基本 信息 页 面 ， 那 么 我 们 
应 该 往 SpitterController 中 添加 一 个 处 理 器 方法 ， 用 来 处 理 对 基本 
言 息 页 面 的 请 求 。 如 下 的 showSpitterProfile() 将 会 完成 这 项 任务 : 





@RequestMapping(value="/{username}", method=GET) 
public String showSpitterprofile( 
@PathVariable String username, Model model) { 


Spitter spitter = spitterRepository.findByUsername(username); 
model.addAttribute(spitter); 
return "profile"; 


} 





SpitterRepository 通 过 用 户 名 获取 一 个 spitter 对 

象 ，showSpitter-Profile() 得 到 这 个 对 象 并 将 其 添加 到 模型 中 ， 然 
后 返回 profile， 也 就 是 基本 信息 页 面 的 逻辑 视图 名 。 像 本 章 展 现 的 其 
他 视图 一 样 ， 现 在 的 基本 信息 视图 非常 简单 : 





<h1>Your Profile</h1> 
<c:out value="${spitter.username}" /><br/> 


<c:out value="${spitter.firstName}" /> 
<c:out value="${spitter.lastName}" /> 





图 5.6 展 现 了 在 Web 浏 览 器 中 泻 染 的 基本 信息 页 面 。 


如 果 表 单 中 没有 发 送 username 或 password 的 话 ， 会 发 生 什 么 情况 呢 ? 
或 者 说 ， 如 果 firstName 或 1astName 的 值 为 空 或 太 长 的 话 ， 又 会 怎么 
样 呢 ? 接 下 来 ， 让 我 们 看 一 下 如 何 为 表单 提交 添加 校 验 ， 从 而 避免 数据 
呈现 的 不 一 致 性 。 





@O0N Spittr 
IE 名 localhost.8080 © Nais lllo 


Your Profile 





jbauer 
Jack Bauer 








图 5.6 ”Spittr 的 基本 信息 页 展现 了 用 户 的 情况 ， 这 些 信息 是 
由 SpitterController 填 充 到 模型 中 的 


























5.4.2 ” 校 验 表单 


如 果 用 户 在 提交 表单 的 时 候 ，username 或 password 文 本 域 为 空 的 话 ， 
那么 将 会 导致 在 新 建 spitter 对 象 中 ，username 或 password 是 空 的 
String。 至 少 这 是 一 种 怪异 的 行为 。 如 果 这 种 现象 不 处 理 的 话 ， 这 将 会 
出 现 安全 问题 ， 因 为 不 管 是 谁 只 要 提交 一 个 空 的 表单 束 能 登录 应 用 。 


同时 ， 我 们 还 应 该 阻止 用 户 提 交 空 的 firstName 和 /或 lastName， 使 应 
用 仪 在 一 定 程度 上 保持 匿名 性 。 有 个 好 的 办 法 就 是 限制 这 些 输入 域 值 的 
长 度 ， 保 持 它们 的 值 在 一 个 合理 的 长 度 范围 ， 避 免 这 些 输入 域 的 误 用 。 


有 种 处 理 校 验 的 方式 非常 初级 ， 那 就 是 在 processRegistration() 方 
法 中 添加 代码 来 检查 值 的 合法 性 ， 如 果 值 不 合法 的 话 ， 就 将 注册 表单 重 
新 显示 给 用 户 。 这 是 一 个 很 简短 的 方法 ， 因 此 ， 添 加 一 些 额外 的 证 语句 
也 不 是 什么 大 问题 ， 对 吧 ? 


与 其 让 校 验 逻 辑 弄 乱 我 们 的 处 理 器 方法 ， 还 不 如 使 用 Spring 对 Java 校 验 
API (Java Validation API， 又 称 JSR-303) 的 支持 。 从 Spring 3.0 开 始 ， 

在 Spring MVC 中 提供 了 对 Java 校 验 API 的 支持 。 在 Spring MVC 中 要 使 用 
Java 校 验 API 的 话 ， 并 不 需要 什么 额外 的 配置 。 只 要 保证 在 类 路 径 下 包 




















含 这 个 Java API 的 实现 即 可 ， 比 如 Hibernate Validator。 
Java 校 验 API 定 义 了 多 个 注解 ， 这 些 注 解 可 以 放 到 属性 上 ， 从 而 限制 这 
些 属性 的 值 。 所 有 的 注解 都 位 于 javax.validation.constraints 包 
中 。 表 5.1 列 出 了 这 些 校 验 注解 。 


表 5.1 Java 校 验 API 所 提供 的 校 验 注 解 








所 注解 的 元 素 必须 是 Boolean 类 型 ， 并 且 值 为 false 
所 注解 的 元 素 必 须 是 Boolean 类 型 ， 并 且 值 为 true 
所 注解 的 元 素 必 须 是 数字 ， 并 且 它 的 值 要 小 于 或 等 于 给 定 的 
@DecimalMax ， ， 
BigDecimalstring 值 


所 注解 的 元 素 必 须 是 数字 ， 并 且 它 的 值 要 大 于 或 等 于 给 定 的 
@DecimalMin : 
BigDecimalstring 值 






































所 注解 的 元 素 必须 是 数字 ， 并 且 它 的 值 必须 有 指定 的 位 数 
所 注解 的 元 素 的 值 必须 是 一 个 将 来 的 
所 注解 的 元 素 必须 是 数字 ， 并 且 它 的 值 要 小 于 或 等 于 给 定 的 值 
所 注解 的 元 素 必 须 是 数字 ， 并 且 它 的 值 要 大 于 或 等 于 给 定 的 值 
所 注解 元 素 的 值 必 须 不 能 为 nul1 

所 注解 元 素 的 值 必须 为 nu11 


@Past 所 注解 的 元 素 的 值 必须 是 一 个 已 过 去 的 日 期 















































所 注解 的 元 素 的 值 必须 匹配 给 定 的 正则 表达 式 





所 注解 的 元 素 的 值 必须 是 string、 集 合 或 数组 ， 并 且 它 的 长 度 要 符合 给 
定 的 范围 

















除了 表 5.1 中 的 注解 ，Java 校 验 API 的 实现 可 能 还 会 提供 额外 的 校 验 注 
解 。 同 时 ， 也 可 以 定义 目 己 的 限制 条 件 。 但 就 我 们 来 讲 ， 将 会 关注 于 上 
表 中 的 两 个 核心 限制 条 件 。 


请 考虑 要 添加 到 Spitter 域 上 的 限制 条 件 ， 似 乎 需要 使 用 @NotNu11 和 
@Size 注 解 。 我 们 所 要 做 的 事情 就 是 将 这 些 注解 添加 到 spitter 的 属性 
上 。 如 下 的 程序 清单 展现 了 Spitter 类 ， 它 的 属性 已 经 添加 了 校 验 注 
解 。 


程序 清单 5.18 ”Spitter: 包含 了 要 提交 到 Spittle POST 请 求 中 的 域 


package spittr; 

import javax.validation.constraints.NotNull; 

import javax.validation.constraints.Size; 

import org.apache.commons.1lang3.builder.EqualsBuilder; 
import org.apache.commons.lang3.builder.HashCodeBuilder; 








public class Spitter { 
private Long id; 


@NotNull i 
GeSizelmin=5，max=16) 非 空 ，$ 到 16 个 字符 
private String username; 





@NotNull 

， 。 w dE23 & a A pi 
@Size{(min=5, max=25) 非 空 ，5 到 25 个 字符 
private String password; 


@NotNull 

@Size{(min=2, max=30) 非 空 ，2 到 30 个 字符 
private String firstName; 

@NotNull 

@Size{min=2, max=30) 非 空 ，2 到 30 个 字符 
private String lastName; 


} 


现在 ，Spitter 的 所 有 属性 都 添加 了 @NotNull 注 解 ， 以 确保 它们 的 值 
不 为 nu11。 类 似 地 ， 属 性 上 也 添加 了 @Size 注 解 以 限制 它们 的 长 度 在 最 


大 值 和 最 小 值 之 间 。 对 Spittr 应 用 来 说 ， 这 意味 着 用 户 必 须要 填 完 注 
册 表 单 ， 并 且 值 的 长 度 要 在 给 定 的 范围 内 。 

我 们 已 经 为 Spitter 添 加 了 校 验 注解 ， 接 下 来 需要 修 

改 processRegistration() 方 法 来 应 用 校 验 功 能 。 局 用 校 验 功 能 的 
processRegistration() 如 下 所 示 : 


程序 清单 5.19 ”processRegistration(): 确保 所 提交 的 数据 是 合法 的 





GRedquestMapping(value="/zregister"，methoQ=POST) 
public String DrocessRegistrationl 
@Valid Spitter spitter, 校 验 Spitter 输入 
Errors errors) { 
if (errors.hasErrors()) { 如 果 校 验 出 现 错误 ， 
return "registerForm"; - 则 重新 返回 表单 


了 


spitterRepository.save(lspitter); 
return "redirect:/spitter/" + spitter.getUsername(}; 


} 


与 程序 清单 5.17 中 最 初 的 processRegistration() 方 法 相 比 ， 这 里 有 
了 很 大 的 变化 。Spitter 参 数 添加 了 @Valid 注 解 ， 这 会 告知 Spring,， 
需要 确保 这 个 对 象 满足 校 验 限制 。 


在 Spitter 属 性 上 添加 校 验 限 制 并 不 能 阻止 表单 提交 。 即 便 用 户 没 有 填 
写 某 个 域 或 者 某 个 域 所 给 定 的 值 超 出 了 最 大 长 

度 ，processRegistration() 方 法 依然 会 被 调 有 用。 这样， 我 们 就 需要 
J 就 像 在 processRegistration() 方 法 中 所 看 到 的 那 


如 果 有 校 验 出 现 错误 的 话 ， 那 么 这 些 错误 可 以 通过 Errors 对 象 进行 访 
问 ， 现 在 这 个 对 象 已 作为 processRegistration() 方 法 的 参数 。 (很 
重要 一 点 需要 注意 ，Errors 参 数 要 紧 跟 在 带 有 @Valid 注 解 的 参数 后 
面 ，@Valid 注 解 所 标注 的 就 是 要 检验 的 参 

数 。) processRegistration() 方 法 所 做 的 第 一 件 事 就 是 调 

用 Errors.hasErrors() 来 检查 是 否 有 错误 。 

















如 果 有 错误 的 话 ，Errors.hasErrors() 将 会 返回 到 registerForm， 
也 就 是 注册 表单 的 视图 。 这 能 够 让 用 户 的 浏览 器 重新 回 到 注册 表单 页 
面 ， 所 以 他 们 能 够 修正 错误 ， 然 后 重新 尝试 提交 。 现 在 ， 会 显示 空 的 表 
单 ， 但 是 在 下 一 章 中 ， 我 们 将 在 表单 中 显示 最 初 提交 的 值 并 将 校 验 错 误 


反馈 给 用 户 。 


如 果 没 有 错误 的 话 ，Spitter 对 象 将 会 通过 Repository 进 行 保存 ， 控 制 
器 会 像 之 前 那样 重 定向 到 基本 信息 人 


5.5 小结 


在 本 章 中 ， 我 们 为 编写 应 用 程序 的 Web 部 分 开 了 一 个 好 头 。 可 以 看 到 ， 
Spring 有 一 个 强大 灵活 的 Web 框 架 。 借 助 于 注解 ，Spring MVC 提 供 了 近 
似 于 POJO 的 开发 模式 ， 这 使 得 开发 处 理 请 求 的 控制 器 变 得 非常 简单 ， 
同时 也 易于 测试 。 


当 编 写 控制 器 的 处 理 器 方法 时 ，Spring MVC 极 其 灵活 。 概 括 来 讲 ， 如 果 
你 的 处 理 器 方法 需要 内 容 的 话 ， 只 需 将 对 应 的 对 象 作为 参数 ， 而 它 不 需 
要 的 内 容 ， 则 没有 必要 出 现在 参数 列表 中 。 这 样 ， 就 为 请 求 处 理 带 来 了 
无 限 的 可 能 性 ， 同 时 还 能 保持 一 种 简单 的 编程 模型 。 


尽管 本 章 中 的 很 多 内 容 部 是 关于 控制 费 的 请 求 处 理 的 ， 但 是 泻 染 啊 应 同 

样 也 是 很 重要 的 。 我 们 通过 使 用 JSP 的 方式 ， 简 单 了 解 了 如 何 为 控制 器 

人 但 是 就 Spring MVC 的 视图 来 次 ， 它 并 不 限于 本 章 所 看 到 的 简 
Jo9P。 


在 接 下 来 的 第 6 章 中 ， 我 们 将 会 更 深入 地 学 习 Spring 视 图 ， 包 括 如 何在 
JSP 中 使 用 Spring 标 俭 库 。 我 们 还 会 学 习 如 何 借 助 Apache Tiles 为 视图 添 
加 一 致 的 布局 结构 。 同 时 ， 还 会 了 解 Thymeleaf， 这 是 一 个 很 有 意思 的 
JSP 蔡 代 方 案 ，Spring 为 其 提供 了 内 置 的 文 持 。 





























。 将 模型 数据 演 染 为 HTML 
。 使 用 JSP 视 图 

。 通过 tiles 定 义 视图 布局 
。 使 用 Thymeleaf 视 图 


上 一 章 主要 关注 于 如 何 编写 处 理 Web 请 求 的 控制 器 。 我 们 也 创建 了 一 些 
简单 的 视图 ， 用 来 演 染 控制 器 产生 的 模型 数据 ， 但 我 们 并 没有 人 花 太 多 时 
闻 讨 论 视 图 ， 也 没有 讨论 控制 器 完 成 请 求 到 结果 泻 染 到 用 户 的 浏览 右 中 
的 这 段 时 间 内 到 底 发 生 了 什么 ， 而 这 正 是 本 章 的 主要 内 容 。 








6.1 理解 视图 解析 


在 第 5 章 中 ， 我 们 所 编写 的 控制 器 方法 都 没有 直接 产生 浏览 器 中 演 染 所 
需 的 HIML。 这 些 方法 只 是 将 一 些 数据 填充 到 模型 中 ， 然 后 将 模型 传递 
给 一 个 用 来 泻 染 的 视图 。 这 些 方 法 会 返回 一 个 String 类 型 的 值 ， 这 个 值 
是 视图 的 逻辑 名 称 ， 不 会 直接 引用 具体 的 视图 实现 。 尺 管 我 们 也 编写 了 
几 个 简单 的 JavaServer Page (JSP) 视图， 但 是 控制 器 并 不 关心 这 些 。 


将 控制 器 中 请 求 处 理 的 逻辑 和 视图 中 的 泻 染 实 现 解 不是 Spring MVC 的 一 
个 重要 特性 。 如 果 控 制 器 中 的 方法 直接 负责 产生 HTML 的 话 ， 就 很 难 在 
不 影响 请 求 处 理 人 逻辑 的 前 提 下 ， 维 护 和 更 新 视图 。 控 制 器 方法 和 视图 的 
实现 会 在 模型 内 容 上 达成 一 致 ， 这 是 两 者 的 最 大 关联 ， 除 此 之 外 ， 两 者 
应 该 保持 足够 的 距离 。 


但 是 ， 如 果 控 制 器 只 通过 人 逻辑 视图 名 来 了 解 视图 的 话 ， 那 Spring 该 如 何 
Ue 哪 一 个 视图 实现 来 泻 染 模型 呢 ? 这 就 是 Spring 视图 解析 口 的 任 
可 

















在 第 5 章 中 ， 我 们 使 用 名 为 InternalResourceViewResolver 的 视图 解 
析 器 。 在 它 的 配置 中 ， 为 了 得 到 视图 的 名 字 ， 会 使 用 “WEB- 
INF/views/” 前 缓和 “.jsp” 后 缀 ， 从 而 确定 来 泻 染 模型 的 JSP 文 件 的 物理 位 
置 。 现 在 ， 我 们 回 过 头 来 看 一 下 视图 解析 的 基础 知识 以 及 Spring 提供 的 
其 他 视图 解析 器 。 


Spring MVC 定 义 了 一 个 名 为 ViewResolver 的 接口 ， 它 大 致 如 下 所 示 : 


public interface ViewResolver { 
View resolveViewName(String viewName, Locale locale) 


throws Exception; 





当 给 resolveViewName( ) 方 法 传 入 一 个 视图 名 和 Locale 对 象 时 ， 它 会 
返回 一 个 View 实 例 。View 是 另外 一 个 接口 ， 如 下 所 示 : 


public interface View { 
String getContentType(); 
void render(Map<String, ?> model, 


HttpServletRequest request, 
HttpServletResponse response) throws Exception; 


} 


View 接 口 的 任务 就 是 接受 模型 以 及 Servlet 的 request 和 response 对 象 ， 并 
将 输出 结果 演 染 到 response 中 。 


这 看 起 来 非常 简单 。 我 们 所 需要 做 的 就 是 编写 ViewResolver 和 View 的 
实现 ， 将 要 泻 染 的 内 容 放 到 response 中 ， 进 而 展现 到 用 户 的 浏览 右 中 。 
对 吧 ? 


实际 上 ， 我 们 并 不 需要 这 么 麻烦 。 尺 管 我 们 可 以 编写 ViewResolver 和 
View 的 实现 ， 在 有 些 特定 的 场景 下 ， 这 样 做 也 是 有 必要 的 ， 但 是 一 般 来 
讲 ， 我 们 并 不 需要 关心 这 些 接口 。 我 在 这 里 提 及 这 些 接口 只 是 为 了 让 你 
对 视图 解析 内 部 如 何 工作 有 所 了 解 。Spring 提 供 了 多 个 内 置 的 实现 ， 如 
表 6.1 所 示 ， 它 们 能 够 适应 大 多 数 的 场景 。 


表 6.1 Spring 自 带 了 13 个 视图 解析 器 ， 能 够 将 逻辑 视图 名 转换 为 物理 实现 


图 解析 器 
将 视图 解析 为 Spring 应 用 上 下 文中 的 bean， 


BeanNameViewResolver 的 ID 与 视图 的 名 字 相 同 




























































































ContentNegotiatingViewResolver De 和 
忆 











类 型 来 解析 视图 ， 委 托 
容 类 型 的 视图 解析 器 








将 视图 解析 为 FreeMarker 模 板 
将 视图 解析 为 Web 应 用 的 内 部 资源 (一 般 为 JSP) 
将 视图 解析 为 JasperReports 定 义 

将 视图 解析 为 资源 bundle (一 般 为 属性 文件 ) 


























TilesViewResolver 将 视 图 解析 为 Apache Tile 定 义 ， 其 中 tile ID 与 视图 名 
称 相 同 o 注意 有 两 个 不 同 的 TilesviewResolver 实 现 ， 
分 别 对 应 于 Tiles 2.0 和 Tiles 3.0 








UrlBasedViewResolver 直接 根据 视图 的 名 称 解析 视图 ， 视 图 的 名 称 会 匹配 
Re se 个 物理 视图 的 定义 





























号 . . 将 视图 解析 为 Velocity 布局 ， 从 不 同 的 Velocity 模板 
elocityLayoutViewResolver 中 组 合 页 面 








将 视图 解析 为 特定 XML 文件 中 的 bean 定义。 类 似 于 


BeanName -ViewResolver 











XmlViewResolver 











将 视图 解析 为 XSLT 转 换 后 的 结果 


Spring 4 和 Spring 3.2 文 持 表 6.1 中 的 所 有 视图 解析 器 。Spring 3.1 文 持 除 
Tiles 3 TilesViewResolver 之 外 的 所 有 视图 解析 器 。 


我 们 没有 足够 的 篇 幅 介 绍 Spring 所 提供 的 13 种 视图 解析 器 。 这 其 实 也 没 
什么 ， 因 为 在 大 多 数 应 用 中 ， 我 们 只 会 用 到 其 中 很 少 的 一 部 分 。 


对 于 表 6.1 中 的 大 部 分 视图 解析 器 来 讲 ， 每 一 项 都 对 应 Java Web 应 用 中 特 
定 的 某 种 视图 技术 。InternalResourceViewResolver 一 般 会 用 于 
JSP，TilesViewResolver 用 于 Apache Tiles 视 图 ， 

而 FreeMarkerViewResolver 和 VelocityViewResolver 分 别 对 应 
FreeMarker 和 Velocity 模 板 视 图 。 


在 本 章 中 ， 我 们 将 会 关注 与 大 多 数 Java 开 发 人 员 最 上 县 相关 的 视图 技 
术 。 因 为 大 多 数 Java Web 应 用 都 会 用 到 JSP， 我 们 首先 将 会 介绍 
InternalResourceViewResolver， 这 个 视图 解析 器 一 般 会 用 来 解析 
JSP 视 图 。 接 下 来 ， 我 们 将 会 介绍 TilesViewResolver， 控 制 JSP 页 面 
的 布局 。 


在 本 章 的 最 后 ， 我 们 将 会 看 一 个 没有 列 在 表 6.1 中 的 视图 解析 器。 











Thymeleaf 是 一 种 用 来 蔡 代 JSP 的 新 兴 技 术 ，Spring 提 供 了 与 Thymeleaf 的 
原生 模板 (natural template) 协作 的 视图 解析 器 ， 这 种 模板 之 所 以 得 到 
这 样 的 称呼 是 因为 它 更 像 是 最 终 产 生 的 HTML， 而 不 是 驱动 它们 的 Java 
代码 。Thymeleaf 是 一 种 非常 令 人 兴奋 的 视图 方案 ， 所 以 你 尽 可 以 先 往 
后 翻 几 页 ， 去 6.4 节 看 一 下 在 Spring 中 是 如 何 使 用 ” 它 的 。 


如 果 你 依然 停留 在 本 页 的 话 ， 那 么 你 可 能 知道 JSP 曾 经 是 ， 而 且 现 在 依 
然 还 是 Java 领 域 占 主导 地 位 的 视图 技术 。 在 以 前 的 项 目 中 ， 也 许 你 使 用 
过 JSP， 将 来 有 可 能 还 会 继续 使 用 这 项 技术 ， 所 以 接 下 来 让 我 们 看 一 下 
如 何在 Spring MVC 中 使 用 JSP ”视图 。 














6.2 创建 JSP 视 图 


不 管 你 是 否 相信 ，JavaServer Pages 作 为 Java Web 应 用 程序 的 视图 技术 已 
经 超过 15 年 了 。 尽 管 开始 的 时 候 它 很 丑陋 ， 只 是 类 似 模板 技术 《如 
Microsoft 的 Active Server Pages) 的 Java 版 本 ， 但 JSP 这 些 年 在 不 断 进 
人 化， 包含 了 对 表达 式 语言 和 上 自 定义 标签 库 的 支持 。 


Spring 提 供 了 两 种 支持 JSP 视 图 的 方式 : 


。InternalResourceViewResolver 会 将 视图 名 解析 为 JSP 文 件 。 田 
外 ， 如 果 在 你 的 JSP 页 面 中 使 用 了 JSP 标 准 标 签 库 〈JavaServer Pages 
Standard Tag Library，JSTL ) 的 
话 ，InternalResourceViewResolver 能 够 将 视图 名 解析 为 
JstlView 形 式 的 JSP 文 件 ， 从 而 将 JSTL 本 地 化 和 资源 bundle 变 量 暴露 
给 JSTEL 的 格式 化 〈formatting) 和 信息 (message) 标签 。 

。 Spring 提供 了 两 个 JSP 标 签 库 ， 一 个 用 于 表单 到 模型 的 绑 定 ， 另 一 个 
提供 了 通用 的 工具 类 特性 。 


不 管 你 使 用 JSTL， 还 是 准备 使 用 Spring 的 JSP 标 签 库 ， 配 置 解析 JSP 的 视 
图 解析 器 都 是 非常 重要 的 。 尽 管 Spring 还 有 其 他 的 几 个 视图 解析 器 都 能 
将 视图 名 映射 为 JSP 文 件 ， 但 就 这 项 任务 来 

讲 ，InternalResourceViewResolver 是 最 简单 和 最 常用 的 视图 解析 
器 。 我 们 在 第 5 章 已 经 接触 到 了 如 何 配 

置 InternalResourceViewResolver。 但 是 在 那里 ， 我 们 只 是 匆忙 体 
验 了 一 下 ， 以 便于 碍 看 控制 器 在 浏览 右 中 的 效果 。 接 下 来 ， 我 们 将 会 更 
加 仔细 地 了 解 InternalResourceViewResolver， 看 看 如 何 让 它 完 
听命 于 我 们 。 


6.2.1 配置 适用 于 JSP 的 视图 解析 器 


有 一 些 视 图 解析 器 ， 如 ResourceBundleViewResolver 会 直接 将 逻辑 
视图 名 映射 为 特定 的 View 接 口 实现 ， 

而 InternalResourceViewResolver 所 采取 的 方式 并 不 那么 直接 。 它 
遵循 一 种 约定 ， 会 在 视图 名 上 添加 前 缀 和 后 级 ， 进 而 确定 一 个 Web 应 用 
中 视图 资源 的 物理 路 径 。 














作为 样 例 ， 考 虑 一 个 简单 的 场景 ， 假 设 逻 辑 视 图 名 为 home。 通 用 的 实践 
是 将 JSP 文 件 放 到 Web 应 用 的 WEB-INF 目 录 下 ， 防 止 对 它 的 直接 访问 。 

如 果 我 们 将 所 有 的 JSP 文 件 都 放 在 “/WEB-INF/views/” 目 录 下 ， 并 且 home 
页 的 JSP 名 为 home.jsp， 那 么 我 们 可 以 确定 物理 视图 的 路 径 就 是 逻辑 视图 
名 home 再 加 上 “/WEB-INF/views/* 前 级 和 “.jsp” 后 级 。 如 图 6.1 所 示 。 





前 级 后 级 
人 / 
| ] | 
/WEB-INF/views/home.jsp 
le 
/ 








逻辑 视图 名 


图 6.1 nternalResourceViewResolver 解 析 视 图 时 ， 
会 在 视图 名 上 添加 前 级 和 后 绥 


当 使 用 @Bean 注 解 的 时 候 ， 我 们 可 以 按照 如 下 的 方式 配置 Internal- 
ResourceView Resolver， 使 其 在 解析 视图 时 ， 遵 循 上 述 的 约定 。 














@Bean 
public ViewResolver viewResolver() { 
InternalResourceViewResolver resolver = 
new InternalResourceViewResolver(); 


resolver.setprefix("/WEB-INF/views/"); 
resolver.setSuffix(".jsp"); 
return resolver; 





作为 蔡 代 方案 ， 如 果 你 更 喜欢 使 用 基于 XML 的 Spring 配 置 ， 那 么 可 以 按 
照 如 下 的 方式 配置 InternalResourceViewResolver: 


<bean id="viewResolver" 
class="org.springframework.web.servlet.Vview. 


InternalResourceViewResolver" 
p:prefix="/WEB-INF/views/" 
p:suffix=" .jsp" /> 





InternalLlResourceViewResolver 配 置 就 绪 之 后 ， 它 就 会 将 逻辑 视图 
名 解析 为 JSP 文 件 ， 如 下 所 示 : 


e。 home 将 会 解析 为 "WEB-INEF/views/home.jsp” 
。 productList 将 会 解析 为 “/WEB-INF/views/productList.jsp” 


。 books/detail 将 会 解析 为 “WEB-INF/views/books/detail.jsp” 


让 我 们 重点 看 一 下 最 后 一 个 样 例 。 当 逻辑 视图 名 中 包含 斜 线 时 ， 这 个 斜 

线 也 会 市 到 资源 的 路 径 名 中 。 因 此 ， 它 会 对 应 到 prefix 属 性 所 引用 目 

> 下 的 JSP 文 件 。 这 样 的 话 ， 我 们 就 可 以 很 方便 地 将 视图 模板 
组 织 为 层级 目录 结构 ， 而 不 是 将 它们 都 放 到 同一 个 目录 之 中 。 


解析 JSTL 视 图 


到 目前 为 止 ， 我 们 对 InternalResourceViewResolver 的 配置 都 很 基 
础 和 简单 。 它 最 终 会 将 逻辑 视图 名 解析 为 InternalResourceView 实 

例 ， 这 个 实例 会 引用 JSP 文 件 。 但 是 如 果 这 些 JSP 使 用 JSTL 标 签 来 处 理 格 
式 化 和 信息 的 话 ， 那 么 我 们 会 希望 InternalResourceViewResolver 
将 视图 解析 为 J]stlView。 


JSTL 的 格式 化 标签 需要 一 个 Locale 对 象 ， 以 便于 恰当 地 格式 化 地 域 相 
关 的 值 ， 如 日 期 和 货币 。 信 ， 生 可 以 借助 Spring 的 信息 资源 和 
Locale, 从 而 选择 适当 的 信息 染 到 HTML 之 中 。 通 过 解析 
JstlView，JSTL 外 6 够 获得 LOC31e 对 象 以 及 Sorinc 中 配置 的 信息 资源 











如 果 想 让 InternalResourceViewResolver 将 视图 解析 为 ]st1lView， 
而 不 是 InternalResourceView 的 话 ， 那 么 我 们 只 需 设 置 它 的 
viewClass 属 性 即 可 : 


@Bean 
public ViewResolver viewResolver() { 
InternalResourceViewResolver resolver = 
new InternalResourceViewResolver(); 
resolver.setprefix("/WEB-INF/views/"); 


resolver.setSuffix(".jsp"); 

resolver.setViewClass( 
org.springframework.web.servlet.view.JstlView.class); 

return resolver:; 





同样 ， 我 们 也 可 以 使 用 XML 完成 这 一 任务 : 





<bean id="viewResolver" 
class="org.springframework.web.servlet.Vview. 
InternalResourceViewResolver" 


p:prefix="/WEB-INF/views/" 
p:suffix=" .jsp" 
p:viewClass="org.springframework.web.servlet.view.JstlView" /> 





不 管 使 用 Java 配 置 还 是 使 用 XML， 都 能 确保 JSTL 的 格式 化 和 信息 标签 能 
够 获得 Locale 对 象 以 及 Spring 中 配置 的 信息 资源 。 


6.2.2 ”使 用 Spring 的 JSP 库 


当 为 JSP 添 加 功能 时 ， 标 签 库 是 一 种 很 强大 的 方式 ， 能 够 避免 在 脚本 块 
中 直接 编写 Java 代 码 。Spring 提 供 了 两 个 JSP 标 签 库 ， 用 来 帮助 定义 
Spring MVC Web 的 视图 。 其 中 一 个 标签 库 会 用 来 泻 染 HTML 表单 标签 ， 
这 些 标 签 可 以 绑 定 mode1 中 的 某 个 属性 。 另 外 一 个 标签 库 包 含 了 一 些 工 
具 类 标签 ， 我 们 随时 都 可 以 非常 便利 地 使 用 它们 。 


在 这 两 个 标签 库 中 ， 你 可 能 会 发 现 表单 绑 定 的 标签 库 更 加 有 用 。 所 以 ， 
我 们 就 从 这 个 标签 库 开 始 学 习 Spring 的 JSP 标 签 。 我 们 将 会 看 到 如 何 将 
Spittr 尿 用 的 注册 表单 绑 定 到 模型 上 ， 这 样 表单 就 可 以 预先 填充 值 ， 并 
且 在 表单 提交 失败 后 ， 能 够 展现 校 验 错误 。 


将 表单 绑 定 到 模型 上 


Spring 的 表单 绑 定 JSP 标 签 库 包 含 了 14 个 标签 ， 它 们 中 的 大 多 数 都 用 来 泻 
染 HTML 中 的 表单 标签 。 但 是 ， 它 们 与 原生 HTML 标 签 的 区 别 在 于 它们 
会 绑 定 模型 中 的 一 个 对 象 ， 能 够 根据 模型 中 对 象 的 属性 填充 值 。 标 签 库 
A 
HTML 之 中 。 


为 了 使 用 表单 绑 定 库 ， 需 要 在 JSP 页 面 中 对 其 进行 声明 : 





























<%Q@ taglib uri="http://www.springframework.org/tags/form”prefix="sf”%> 


需要 注意 ， 我 将 前 绥 指 定 为 sf"， 但 通常 也 可 能 使 用 "formz 前 绥 。 你 可 
以 选择 任意 喜欢 的 前 级 ， 我 之 所 以 选择 “sf" 是 因为 它 很 简洁 、 易 于 输 

入 ， 并 且 还 是 Spring form 的 简写 形式 。 在 本 书 中 ， 当 使 用 表单 绑 定 库 的 
时 候 ， 我 会 一 直 使 用 “sf” 前 级 。 


在 声明 完 表 单 绑 定 标签 库 之 后 ， 你 就 可 以 使 用 14 个 相关 的 标签 了 。 如 表 





6.2 所 示 。 


表 6.2 ”借助 Spring 表单 绑 定 标签 库 中 所 包含 的 标签 ， 我 们 能 够 将 模型 对 象 绑 定 到 泻 染 后 的 
HTML 表 单 中 




















JSP 标 签 


<sf:checkbox> 泻 染 成 一 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 checkbox 


:checkboxes> | 演 染 成 多 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 checkbox 


在 一 个 HTML <span> 中 泻 染 输入 域 的 错 误 


Ce Om 渲染 成 一 个 HTML “form> 标 签 ， 并 为 其 内 部 标签 暴露 绑 定 路 径 ， 
用 于 数据 绑 定 
演 染 成 一 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 nidden 

































































Ce ae 人 
<sf:1abel> 演 染 成 一 个 HTML “label> 标 签 


es 染 成 一 个 HTML “<option> 标 签 ， 其 selected 属 性 根据 所 绑 定 的 值 
2 


按照 绑 定 的 集合 、 数 组 或 Map， 演 染 成 一 个 HTML <option> 标 签 的 
<sf:options> 
列表 
Ce ae 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 password 


:radiobutton> | 演 染 成 一 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 radio 


















































十 


:radiobuttons> | 演 染 成 多 个 HTML <input> 标 签 ， 其 中 type 属 性 设置 为 radio 


<“S 




















演 染 为 一 个 HTML <select> 标 签 


<sf:textarea> 泻 染 为 一 个 HTML <textarea> 标 签 


要 在 一 个 样 例 中 介绍 所 有 的 这 些 标签 是 很 困难 的 ， 如 果 一 定 要 这 样 做 的 
话 ， 肯定 也 会 非常 牵强 。 就 Spittr 样 例 来 说 ， 我 们 只 会 用 到 适合 于 Spittr 
应 用 中 注册 表单 的 标签 。 有 具体 来 讲 ， 也 就 是 <sf:form>、<sf:input> 
和 <sf:password>。 在 注册 JSP 中 使 用 这 些 标签 后 ， 所 得 到 的 程序 如 下 
所 示 : 


<sf:form method="POST" commandName="spitter"> 
First Name: <sf:input path="firstName” /><br/> 
Last Name: <sf:input path="lastName" /><br/> 
Email: <sf:input path="email" /><br/> 
Username: <sf:input path="username" /><br/> 
Password: <sf:password path="password" /><br/> 
<input type="submit" value="Register" /> 

</sf:form> 





<sf:form> 会 演 染 会 一 个 HTML <form> 标 签 ， 但 它 也 会 通过 
commandName 属 性 构建 针对 某 个 模型 对 象 的 上 下 文 信息 。 在 其 他 的 表单 
绑 定 标签 中 ， 会 引用 这 个 模型 对 象 的 属性 。 


在 之 前 的 代码 中 ， 我 们 将 commandName 属 性 设置 为 spitter。 因 此 ， 在 
必须 要 有 一 个 key 为 spitter 的 对 象 ， 否 则 的 话 ， 表 单 不 能 正常 

宣 染 《〈 会 出 现 JSP 错 误 ) 。 这 意味 着 我 们 需要 修改 一 
ee 以 确保 模型 中 存在 以 spitter 为 key 的 
Spitter 对 象 : 








@RequestMapping(value="/register", method=GET) 
public String showRegistrationForm(Model model) { 


model.addAttribute(new Spitter()); 
return "registerForm"; 


} 





修改 后 的 showRegistrationForm( ) 方 法 中 ， 新 增 了 一 个 spitter 实 例 
到 模型 中 。 模 型 中 的 key 是 根据 对 象 类 型 推断 得 到 的 ， 也 整 








征 spitter， 与 我 们 所 需要 的 完全 一 致 。 


回 到 这 个 表单 中 ， 前 四 个 输入 域 将 HTML <input> 标 签 改 成 了 
<sf:input>。 这 个 标签 会 泻 染 成 一 个 HIML <input> 标 签 ， 并 且 type 
属性 将 会 设置 为 text。 我 们 在 这 里 设置 了 path 属 性 ，<input> 标 签 的 
value 属 性 值 将 会 设置 为 模型 对 象 中 path 属 性 所 对 应 的 值 。 例 如 ， 如 果 
在 模型 中 spitter 对 象 的 firstName 属 性 值 为 J]Jack， 那 么 <sf:input 
path="firstName"/> 所 泻 染 的 <input> 标 签 中 ， 会 存 

在 value="Jack"。 


对 于 password 输 入 域 ， 我 们 使 用 <sf:password> 来 代 蔡 
<sf:input>。<sf:password> 与 <sf:input> 类 似 ， 但 是 它 所 泻 染 的 
HTML <input> 标 签 中 ， 会 将 type 属 性 设置 为 password， 这 样 当 输 入 
的 时 候 ， 它 的 值 不 会 直接 明文 显示 。 


为 了 帮助 读者 了 解 最 终 的 HIML 看 起 来 是 什么 样子 的 ， 假 设 有 个 用 户 已 
经 提交 了 表单 ， 但 值 都 是 不 合法 的 。 校 验 失 败 后 ， 用 户 会 被 重 定向 到 注 
册 表 单 ， 最 终 的 HTML<form> 元 素 如 下 所 示 : 











<form id="spitter" action="/spitter/spitter/register" method="POST"> 
First Name: 
<input id="firstName" 
name="firstName" type="text" value="J"/><br/> 
Last Name: 
<input id="lastName" 
name="lastName" type="text" value="B"/><br/> 
Email: 
<input id="email" 
name="email" type="text" value="jack"/><br/> 
Username: 
<input id="username" 
name="Username" type="text" value="jack"/><br/> 
Password: 
<input id="password" 
name="password" type="password" value=""/><br/> 
<input type="submit" value="Register" /> 
</form> 








值得 注意 的 是 ， 从 Spring 3.1 开 始 ，<sf: input> 标 签 能 够 允许 我 们 指定 
type 必 性， 这样 的 话 ， 除 了 其 他 可 选 的 类 型 外 ， 还 能 指定 HTML 5 特定 
类 型 的 文本 域 ， 如 date、range 和 email。 例 如 ， 我 们 可 以 按照 如 下 的 





方式 指定 email 域 : 





Email: <sf:input path="email" type="email" /><br/> 
这 样 所 泻 染 得 到 的 HTML 如 下 所 示 : 


Email: 





<input id="email" name="email" type="email" value="jack"/><br/> 


相对 于 标准 的 HTML 标 签 ， 使 用 Spring 的 表单 绑 定 标签 能 够 带 来 一 定 的 
功能 提升 ， 在 校 验 失败 后 ， 表 单 中 会 预先 填充 之 前 输入 的 值 。 但 是 ， 这 
依然 没有 告诉 用 户 错 在 什么 地 方 。 为 了 指导 用 户 矫 正 错误 ， 我 们 需要 使 


用 <sf:errors>。 

展现 错误 

如 果 存 在 校 验 错误 的 话 ， 请 求 中 会 包含 错误 的 详细 人 信息， 这些 信 息 是 与 
模型 数据 放 到 一 起 的 。 我 们 所 需要 做 的 就 是 到 模型 中 将 这 些 数据 抽取 出 
来 ， 并 展现 给 用 户 。<sf:errors> 能 够 让 这 项 任务 变 得 很 简单 。 

例如 ， 让 我 们 看 一 下 将 <sf:errors> 用 到 registerForm.jsp 中 的 代码 片 


段 : 











<sf:form method="POST" commandName="spitter"> 
First Name: <sf:input path="firstName” /> 
<sf:errors path="firstName" /><br/> 





</sf:form> 


尽管 我 只 展现 了 将 <sf:errors> 用 到 First Name 输 入 域 的 场景 ， 但 是 它 
可 以 按照 同样 简单 的 方式 用 到 注册 表单 的 其 他 输入 域 中 。 在 这 里 ， 它 的 
path 属 性 设置 成 了 firstName， 也 就 是 指定 了 要 显示 Spitter 模 型 对 象 
中 哪个 属性 的 错误 。 如 果 firstName 属 性 没有 错误 的 话 ， 那 

么 <sf:errors> 不 会 泻 染 任何 内 容 。 但 如 果 有 校 验 错误 的 话 ， 那 么 它 将 
会 在 一 个 HTML <span> 标 签 中 显示 错误 信息 。 


例如 ， 如 果 用 户 提交 字母 “六 作为 名 字 的 话 ， 那 么 如 下 的 HIML 片段 就 是 
针对 First Name 输 入 域 所 显示 的 内 容 : 








First Name: <input id="firstName" 


name="firstName" type="text" value="J"/> 
<Span id="firstName.errors">size must be between 2 and 38</span> 





现在 ， 我 们 已 经 可 以 为 用 户 展现 错误 信息 ， 这 样 他 们 就 能 修正 这 些 错 误 
J I 修改 错误 的 样式 ， 使 其 更 加 突出 显示 。 为 了 做 
到 这 一 点 ， 可 以 设置 cssClass 属 性 : 


<sf:form method="POST” commandName="spitter” > 
First Name: <sf:input path="firstName” /> 
<sf:errors path="firstName" cssClass="error" /><br/> 


</sf:form> 








同样 ， 简 单 起 见 ， 我 只 会 展现 如 何 为 firstName 输 入 域 的 <sf:errors> 
设置 cssClass 属 性 。 你 可 以 将 其 用 到 其 他 的 输入 域 上 。 


现在 errors 的 <span> 会 有 一 个 值 为 error 的 class 属 性 。 剩 下 需要 做 的 
如 下 就 是 一 个 简单 的 CSS 样 式 ， 它 会 将 错 
误 吾 已 Jy 红 








span.error { 


color: red; 





} 
ey 
图 6.2 展 现 了 这 个 表单 此 时 在 浏览 器 中 的 显 式 效果 。 
信人 0O Spititr 
| | 9 locathost:8080 € ss) Cl 
Register 
First Name: ) size must be between 2 and 30 
Last Name: 8 size must be between 2and 30 
Usemame: jack size must be between 5 and 16 
Password: Size must be between 5 and 25 


Register 














图 6.2 ”在 表单 输入 域 的 旁边 展现 校 验 错误 信息 




















在 输入 域 的 劳 边 展现 错误 信息 是 一 种 很 好 的 方式 ， 这 样 能 够 引起 用 户 的 
关注 ， 提 醒 他 们 修正 错误 。 但 这 样 也 会 带 来 布局 的 问题 。 男 外 一 种 处 理 
校 验 错误 方式 就 是 将 所 有 的 错误 信息 在 同一 个 地 方 进行 显示 。 为 了 做 到 
这 一 点 ， 我 们 可 以 移 除 每 个 输入 域 上 的 <sf:errors> 元 素 ， 并 将 其 放 到 
表单 的 项 部 ， 如 下 所 示 : 


<sf:form method="POST" commandName="spitter” > 
<sf:errors path="*" element="div" cssClass="errors" /> 


</sf:form> 








这 个 <sf:errors> 与 之 前 相 比 ， 值 得 注意 的 不 同 之 处 在 于 它 的 path 被 
设置 成 了 “*”。 这 是 一 个 通配符 选择 器 ， 会 告诉 <sf:errors> 展 现 所 有 
属性 的 所 有 错误 。 


同样 需要 注意 的 是 ， 我 们 将 element 属 性 设置 成 了 div。 默 认 情 况 下 ， 
错误 都 会 演 染 在 一 个 HTML <span> 标 签 中 ， 如 果 只 显示 一 个 错误 的 
话 ， 这 是 不 错 的 选择 。 但 是 ， 如 果 要 泻 染 所 有 输入 域 的 错误 的 话 ， 很 可 
能 要 展现 不 止 一 个 错误 ， 这 时 候 使 用 <span> 标 签 ( 行 内 元 素 ) 就 不 合 
适 了 。 像 <div> 这 样 的 块 级 元 素 会 更 为 合适 。 因 此 ， 我 们 可 以 

将 element 属 性 设置 为 div， 这 样 的 话 ， 错 误 束 会 泻 染 在 一 个 <div> 标 
签 中 。 








像 之 前 一 样 ，cssClass 属 性 被 设置 errors， 这 样 我 们 就 能 为 <div> 设 
置 样式 。 如 下 为 <div> 的 CSS 样 式 ， 它 有 具有 红色 的 边框 和 浅 红 色 的 背 


司 


div.errors { 
background-color: #ffcccc; 


border: 2px solid red; 


} 


现在 ， 我 们 在 表单 的 上 方 显示 所 有 的 错误 ， 这 样 页 面 布局 可 能 会 更 加 容 
易 一 些 。 但 是 ， 我 们 还 没有 着 重 显 示 需 要 修正 的 输入 域 。 通 过 为 每 个 输 
入 域 设置 cssErrorClass 属 性 ， 这 个 问题 很 容易 解决 。 我 们 也 可 以 将 每 
个 label 都 蔡 换 为 <sf: label>， 并 设置 它 的 cssErrorClass 属 性 。 如 
下 束 是 做 完 必要 修改 后 的 First Name 输 入 域 : 








<sf:form method="POST” commandName="spitter” > 
<sf:label path="firstName" 
cssErrorClass="error">First Name</sf:1abel>: 
<sf:input path="firstName" cssErrorClass="error" /><br/> 


</sf:form> 





<sf: 1abel> 标 签 像 其 他 的 表单 绑 定 标签 一 样 ， 使 用 path 来 指定 它 属 
于 模型 对 象 中 的 哪个 属性 。 在 本 例 中 ， 我 们 将 其 设置 为 firstName， 
此 它 会 绑 定 Spitter 对 象 的 firstName 属 性 。 假 设 没 有 校 验 错误 的 话 ， 
它 将 会 泻 染 为 如 下 的 HTML<1abe1> 元 素 : 


<label for="firstName">First Name</label> 


就 其 自身 来 说 ， 设 置 <sf:1label> 的 path 属 性 并 没有 完成 太 多 的 功能 。 

但 是 ， 我 们 还 同时 设置 了 cssErrorClass 属 性 。 如 果 它 所 绑 定 的 属性 有 
任何 错误 的 话 ， 在 泻 染 得 到 的 <label> 元 素 中 ，class 属 性 将 会 被 设置 
为 error， 如 下 所 示 : 


<label for="firstName" class="error">First Name</label> 





与 之 类 似 ，<sf:input> 标 签 的 cssErrorClass 属 性 被 设置 为 error。 
如 果 有 任何 校 验 错误 的 话 ， 在 泻 染 得 到 的 <input> 标 签 中 ，class 属 性 
将 会 被 设置 为 error。 现 在 我 们 已 经 为 文本 标记 和 输入 域 设置 了 样式 ， 
这 样 当 出 现 错误 的 时 候 ， 会 将 用 户 的 注意 力 转移 到 此 处 。 例 如 ， 如 下 的 
CSS 会 将 文本 标记 泻 染 为 红色 ， 并 将 输入 域 设 置 为 浅 红色 背景 : 


label.error { 
color: red; 


input.error { 
background-color: #ffcccc; 


} 








现在 ， 我 们 有 了 很 好 的 方式 为 用 户 展 现 错误 信息 。 不 过 ， 我 们 还 可 以 做 
另外 一 件 事 情 ， 能 够 让 这 些 错误 信息 更 加 易 读 。 重 新 看 一 下 Spitter 
类 ， 我 们 可 以 在 校 验 注解 上 设置 message 属 性 ， 使 其 引用 对 用 户 更 为 友 
好 的 信息 ， 而 这 些 信息 可 以 定义 在 属性 文件 中 : 











@NotNull 
@Size(min=5, max=16, message="{username.size}") 
private String username; 


@NotNull 
@Size(min=5, max=25, message="{password.size}") 
private String password; 


@NotNull 


@Size(min=2, max=360, message="{firstName.size}") 
private String firstName; 


@NotNull 
@Size(min=2, max=360, message="{lastName.size}") 
private String lastName; 


@NotNull 
@Email(message="{email.valid}") 
private String email; 





对 于 上 面 每 个 域 ， 我 们 都 将 其 @Size 注 解 的 message 设 置 为 一 个 字符 
串 ， 这 个 字符 串 是 用 大 插 号 插 起 来 的 。 如 果 没 有 大 括号 的 话 ，message 
中 的 值 将 会 作为 展现 给 用 户 的 错误 信息 。 但 是 使 用 了 大 括号 之 后 ， 我 们 
使 用 的 就 是 属性 文件 中 的 某 一 个 属性 ， 该 属性 包含 了 实际 的 信息 。 


接 下 来 需要 做 的 就 是 创建 一 个 名 为 ValidationMessages.properties 的 文 
件 ， 并 将 其 放 在 根 类 路 径 之 下 : 











firstName.size= 

First name must be between {min} and {max} characters long. 
lastName.size= 

Last name must be between {min} and {max} characters long. 


username.size= 

Username must be between {min} and {max} characters long. 
password.size= 

Password must be between {min} and {max} characters long. 
email.valid=The email address must be valid. 








ValidationMessages.properties 文 件 中 每 条 信息 的 key 值 对 应 于 注解 中 
message 属 性 占 位 符 的 值 。 同 时 ， 最 小 和 最 大 长 度 没 有 硬 编码 在 
ValidationMessages.properties 文 件 中 ， 在 这 个 用 户 友好 的 信息 中 也 有 自 
己 的 占 位 符 一 一 {min} 和 {max} 一 一 它们 会 引用 @Size 注 解 上 所 设置 的 
min 和 max 属 性 。 


当 用 户 提 交 的 注册 表单 校 验 失败 的 话 ， 他 们 在 浏览 费 中 应 该 可 以 看 到 图 
6.3 所 示 的 界面 。 


将 这 些 错误 信息 抽取 到 属性 文件 中 还 会 种 来 一 个 好 处 ， 那 就 是 我 们 可 以 
通过 创建 地 域 相关 的 属性 文件 ， 为 用 户 展 现 特定 语言 和 地 域 的 信息 。 例 
如， 如 果 用 户 的 浏览 器 设 置 成 了 硬 班 牙 语 ， 那 么 束 应 该 用 西班牙 语 展现 
错误 信息 ， 我 们 需要 创建 一 个 名 为 ValidationMessages.properties 的 文 

件 ， 内 容 如 下 : 








ON Spittr c 
i 总 | @ iocaihoscaoa0 Ce OE Cs 


Register 


Password must be between 5 and 25 characters long. 
semame must be between 5 and 16 characters long. 
irst name must be between 2 and 30 characters long. 
ast name must be between 2 and 30 characters long. 
First Name: 
Last Name: 下 





Usemame: |jack 
Password: 
Regisser 























图 6.3 ”显示 校 验 错误 ， 其 中 这 些 对 用 户 友好 的 信息 是 从 属性 文件 中 获取 到 的 


firstName.size= 

Nombre debe ser entre {min} y {max} caracteres largo. 
lastName.size= 

El apellido debe ser entre {min} y {max} caracteres largo. 


username.size= 

Nombre de usuario debe ser entre {min} y {max} caracteres largo. 
password.size= 

Contraseria debe estar entre {min} y {max} caracteres largo. 
email.valid=La direccion de email no es véalida 





我 们 可 以 按 需 创建 任意 数量 的 ValidationMessages.properties 文 件 ， 使 其 
涵盖 我 们 想 支 持 的 所 有 语言 和 地 域 。 


Spring 通用 的 标签 库 
除了 表单 绑 定 标签 库 之 外 ，Spring 还 提供 了 更 为 通用 的 JSP 标 签 库 。 实 际 








上 ， 这 个 标签 库 是 Spring 中 最 早 的 标签 库 。 这 么 多 年 来 ， 它 有 所 变化 ， 





但 是 在 最 早 版 本 的 Spring 中 ， 
要 使 用 Spring 通用 的 标签 库 ， 我 们 必须 要 在 页 面 上 对 其 进行 声明 : 





<%@ taglib uri="http://www.springframework.org/tags" prefix="s" %> 


与 其 他 JSP 标 签 库 一 样 ，prefix 可 以 是 任意 你 所 喜欢 的 值 。 在 这 里 ， 通 
用 的 做 法 是 将 这 个 标签 库 的 前 级 设置 为 spring。 但 是 ， 我 将 其 设置 
为 “s”， 因 为 它 更 加 简洁， 更 易于 阅读 和 输入 。 


标签 库 声 明之 后 ， 我 们 就 可 以 使 用 表 6.3 中 的 十 个 JSP 标 签 了 。 
表 6.3 ”Spring 的 JSP 标 签 库 中 提供 了 多 个 便利 的 标签 ， 还 包括 一 些 遗 留 的 数据 绑 定 标签 


JSP 标 签 


人 将 绑 定 属性 的 状态 导出 到 一 个 名 为 status 的 页 面 作用 域 属 
与 <s:path> 组 合 使 用 获取 绑 定 属性 的 值 
将 标签 体 中 的 内 容 进 行 HTML 和 /或 JavaScript 转 义 


根据 指定 模型 对 象 〈 在 请 求 属性 中 〉 是 否 有 绑 定 错误 ， 有 条 件 地 
演 染 内 容 


为 当前 页 面 设置 默认 的 HTML 转 义 值 


根据 给 定 的 编码 获取 信息 ， 然 后 要 么 进行 泻 染 (默认 行为 ) ， 要 
<s:message> 0 请 求 作 用 域 、 会 话 作 用 域 或 应 用 作用 
域 的 变量 (通过 使 用 var 和 scope 属 性 实现 ) 


根据 给 定 的 编码 获取 主题 信息 ， 然后 要 么 进行 演 染 (默认 行 
<s:themey> 为 ) ， 要 么 将 其 设置 为 页 面 作 用 域 、 请 求 作 用 域 、 会 话 作 用 域 或 
念 用 作用 域 的 变量 (通过 使 用 var 和 scope 属 性 实现 ) 






























































<s:hasBindErrors> 





















































































































































使 用 命令 对 象 的 属性 编辑 器 转换 命令 对 象 中 不 包含 的 属性 





创建 相对 于 上 下 文 的 URL， 支 持 URI 模 板 变 量 以 及 
HTML/XML/JavaScript 转 义 。 可 以 泻 染 URL (默认 行为 ) ， 也 可 
以 将 其 设置 为 页 面 作用 域 、 请 求 作 用 域 、 会 话 作 用 域 或 应 用 作用 
域 的 变量 (通过 使 用 var 和 scope 属 性 实现 ) 



























































计算 符合 Spring 表 达 式 语言 (Spring Expression Language，SpEL ) 
语法 的 某 个 表达 式 的 值 ， 然 后 要 么 进行 泻 染 〈 默 认 行 为 ) ， 要 么 
将 其 设置 为 页 面 作用 域 、 请 求 作 用 域 、 会 话 作 用 域 或 应 用 作用 域 
的 变量 (通过 使 用 var 和 scope 属 性 实现 ) 



























































表 6.3 中 的 一 些 标签 已 经 被 Spring 表单 绑 定 标签 库 淘 汰 了 。 例 
如 ，<s:bind> 标 签 就 是 Spring 最 初 所 提供 的 表单 绑 定 标签 ， 它 比 我 们 在 
前 面 所 介绍 的 标签 复杂 得 多 。 


因为 这 些 标签 库 的 行为 比 表 单 绑 定 标签 少 得 多 ， 上 所 以 我 不 会 详细 介绍 每 
个 标签 ， 而 是 快速 介绍 几 个 最 为 有 用 的 标签 ， 其 余 的 留 给 读者 目 行 去 学 
习 和 探索 。〔 即 便 你 们 会 用 到 它们 ， 很 可 能 也 不 会 那么 频繁 。) 

展现 国际 化 信息 

到 现在 为 止 ， 我 们 的 JSP 模 板 包 含 了 很 多 便 编 码 的 文本 。 这 其 实 也 算 不 
上 什么 大 问题 ， 但 是 如 果 你 要 修改 这 些 文本 的 话 ， 就 不 那么 容易 了 。 而 
且 ， 没 有 办 法 根据 用 户 的 语言 设置 国际 化 这 些 文本 。 

例如 ， 考 虑 首页 中 的 欢迎 信息 : 


<hi>Welcome to Spittr!</h1i> 


修改 这 个 信息 的 唯一 办 法 是 打开 home.jsp， 然 后 对 其 进行 变更 。 我 觉 
得 ， 这 算 不 上 什么 大 事 。 但 是 ， 应 用 中 的 文本 散布 到 多 个 模板 中 ， 如 果 
要 大 规模 修改 应 用 的 信息 时 ， 你 需要 修改 大 量 的 JSP 文 件 。 


为 外 一 个 更 为 重要 的 问题 在 于 ， 不 管 你 选择 什么 样 的 欢迎 信息 ， 所 有 的 
用 户 都 会 看 到 同样 的 信息 。Web 是 全 球 性 的 网 络 ， 你 所 构建 的 应 用 很 可 























能 会 有 全 球 化 用 户 。 因 此 ， 最 好 能 够 使 用 用 户 的 语言 与 其 进行 交流 ， 而 
不 是 只 使 用 茶 一 种 语言 。 


对 于 泻 染 文 本 来 说 ， 是 很 好 的 方案 ， 文 本 能 够 位 于 一 个 或 多 个 属性 文件 
中 。 借 助 <s :message>， 我 们 可 以 将 硬 编码 的 欢迎 信息 蔡 换 为 如 下 的 形 
式 : 


<h1><s:message code="spittr.welcome" /></h1> 


按照 这 里 的 方式 ，<s :message> 将 会 根据 key 为 spittr .welcome 的 信息 
源 来 演 染 文本 。 因 此 ， 如 果 我 们 希望 <s :message> 能 够 正常 完成 任务 的 
话 ， 就 需要 配置 一 个 这 样 的 信息 源 。 


Spring 有 多 个 信息 源 的 类 ， 它 们 都 实现 了 MessageSource 接 口 。 在 这 些 
类 中 ， 更 为 常见 和 有 用 的 是 ResourceBundleMessageSource。 它 会 从 
一 个 属性 文件 中 加 载 信息 ， 这 个 属性 文件 的 名 称 是 根据 基础 名 称 (base 
name) 衍生 而 来 的 。 如 下 的 @Bean 方 法 配置 了 


ResourceBundleMessageSource: 











@Bean 
public MessageSource messageSource() { 
ResourceBundleMessageSource messageSource = 


new ResourceBundleMessageSource( ) ; 
messageSource.setBasename("messages"); 
return messageSource; 


} 





在 这 个 bean 声 明 中 ， 核 心 在 于 设置 basename 属 性 。 你 可 以 将 其 设置 为 

任意 你 喜欢 的 值 ， 在 这 里 ， 我 将 其 设置 为 nessage。 将 其 设置 

为 message 后 ，ResourceBundle-MessageSource 就 会 试图 在 根 路 径 

这 些 属性 文件 的 名 称 是 根据 这 个 基础 名 称 衍 生 
得 到 的 。 


另外 的 可 选 方案 是 使 

用 ReloadableResourceBundleMessageSource， 它 的 工作 方式 

与 ResourceBundleMessageSource 非 常 类 似 ， 但 是 它 能 够 重新 加 载 信 
恩 属性 ， 而 不 必 重 新 编译 或 重启 应 用 。 如 下 是 配 

置 ReloadableResourceBundle-MessageSource 的 样 例 : 








@Bean 
public MessageSource messageSource() { 
ReloadableResourceBundleMessageSource messageSource = 
new ReloadableResourceBundleMessageSource(); 


messageSource.setBasename("file:///etc/spittr/messages"); 
messageSource.setCacheSeconds(10); 
return messageSource; 





这 里 的 关键 区 别 在 于 basename 属 性 设置 为 在 应 用 的 外 部 查找 (而 不 是 
像 ResourceBundleMessageSource 那 样 在 类 路 径 下 查 

找 ) 。basename 属 性 可 以 设置 为 在 类 路 径 下 (以 “classpath:” 作 为 前 
级 ) 、 文 件 系 统 中 以 “file:” 作 为 前 级 ) 或 Web 应 用 的 根 路 入 下 没 
有 前 级 ) 碍 找 属性 。 在 这 里 ， 我 将 其 配置 为 在 服务 器 文件 系统 

的 “/etc/spittr”* 目 录 下 的 属性 文件 中 查找 信息 ， 并 且 基 础 的 文件 名 


为 “message”。 


现在 ， 我 们 来 创建 这 些 属性 文件 。 首 先 ， 创 建 默认 的 属性 文件 ， 名 为 
messages. Droperties。 它 要 么 位 于 根 类 路 径 下 《如 果 使 

用 ResourceBundleMessageSource 的 话 ) ， 要 么 位 于 pathname 属 性 指 
定 的 路 径 下 《〈 如 果 使 用 ReloadableResourceBundle-MessageSource 
的 话 ) 。 对 spittr.welcome 信 息 来 讲 ， 它 需要 如 下 的 条 目 : 


spittr.welcome=Welcome to Spittr! 


如 果 你 不 再 创建 其 他 信息 文件 的 话 ， 那 么 我 们 所 做 的 事情 束 古 将 JSP 中 
便 编 码 的 信息 抽取 到 了 属性 文件 中 ， 依 然 作 为 硬 编码 的 信息 。 它 能 够 让 
Uy 式 地 修改 应 用 中 的 所 有 信息 ， 但 是 它 所 完成 的 任务 并 不 限于 
es 


我 们 已 经 具备 了 对 信息 进行 国际 化 的 重要 组 成 部 分 。 例 如 ， 如 果 你 想 要 


为 语言 设置 为 西班牙 语 的 用 户 展现 西班牙 语 的 欢迎 信息 ， 那 么 需要 创建 
另外 一 个 名 为 messages_es. properties 的 属性 文件 ， 并 包含 如 下 的 条 目 : 


spittr.welcome=Bienvenidos a Spittr! 


现在 ， 我 们 已 经 完成 了 一 件 了 不 起 的 事情 。 我 们 的 应 用 目前 只 是 多 了 几 
个 <s:message> 标 签 以 及 语言 相关 的 属性 文件 ， 还 没有 完全 实现 国际 
化 ! 我 将 应 用 其 他 部 分 的 国际 化 留 给 读者 去 完成 。 


























创建 URL 


<s :url> 是 一 个 很 小 的 标签 。 它 主要 的 任务 束 是 创建 URL， 然 后 将 其 赋 
值 给 一 个 变量 或 者 泻 染 到 响应 中 。 它 是 JSTL 中 <c:ur1> 标 签 的 蔡 代 者 ， 
但 是 它 具 备 儿 项 特殊 的 技巧 。 


按照 其 最 简单 的 形式 ，<s :url> 会 接受 一 个 相对 于 Servlet 上 下 文 的 
URL， 并 在 泻 染 的 时 候 ， 预 先 添加 上 Servlet 上 下 文 路 径 。 例 如 ， 考 虑 如 
下 xs :url> 的 基本 用 法 : 











<a href="<s:url href="/spitter/register" />">Register</a> 


如 果 应 用 的 Servlet 上 下 文 名 为 spittr， 那 么 在 响应 中 将 会 泻 染 如 下 的 
HTML: 


<a href="/spittr/spitter/register">Register</a> 


这 样 ， 我 们 在 创建 UREL 的 时 候 ， 就 不 必 再 担心 Servlet 上 下 文 路 径 是 什么 
了 ，<s:url> 将 会 负责 这 件 事 。 


男 外 ， 我 们 还 可 以 使 用 <s :url> 创 建 URL， 并 将 其 赋值 给 一 个 变量 供 柑 
板 在 稍 后 使 用 : 


<si:url href="/spitter/register" var="registerUrl" /> 





<a href="${registerUrl}">Register</a> 





默认 情况 下 ，URL 是 在 页 面 作用 域内 创建 的 。 但 是 通过 设置 scope 属 
0 BD 会 话 作 用 域内 或 请 求 作 用 域 
| 建 URL: 


<S:Url href="/spitter/register" var="registerUrl" scope="request" /> 





如 果 和 希望 在 URL 上 添加 参数 的 话 ， 那 么 你 可 以 使 用 <cs:param> 标 签 。 比 
如 ， 如 下 的 <s :url> 使 用 两 个 内 髋 的 <s:param> 标 签 ， 来 设 
置 “/spittles” 的 max 和 count 参 数 : 





<s:url href="/spittles" var="spittlesUrl"> 


<S:param name="max”Vvalue="66”/> 
<S:param name="count" value="20" /> 
</s:url> 





到 目前 为 止 ， 我 们 还 没有 看 到 <s:ur1> 能 够 实现 ， 而 JSTL 的 <c:ur1> 无 
法 实现 的 功能 。 但 是 ， 如 果 我 们 需要 创建 带 有 路 径 〈path) 参数 的 URL 
该 怎么 办 呢 ? 我 们 该 如 何 设置 href 属 性 ， 使 其 具有 路 径 变量 的 占 位 符 
呢 ? 


例如 ， 假 设 我 们 需要 为 特定 用 户 的 基本 信息 页 面 创建 一 个 URL。 那 没有 
问题 ，<s :param> 标 签 可 以 承担 此 任 : 














<S:Url href="/spitter/{username}" var="spitterUrl"> 


<s:param name="username" value="jbauer" /> 
</s:url> 





当 href 属 性 中 的 占 位 符 匹 配 <s :param> 中 所 指定 的 参数 时 ， 这 个 参数 将 
会 插入 到 占 位 符 的 位 置 中 。 如 果 <s:param> 参 数 无 法 匹配 href 中 的 任何 
占 位 符 ， 那 么 这 个 参数 将 会 作为 查询 参数 。 


<s :Url> 标 签 还 可 以 解决 URL 的 转 义 需求 。 例 如 ， 如 果 你 希望 将 泻 染 得 
到 的 URL 内 容 展 现在 Web 页 面 上 《而 不 是 作为 超 链接 ) ， 那 么 你 应 该 要 
求 <s :url> 进 行 HTML 转 义 ， 这 需要 将 htmlEscape 属 性 设置 为 true。 
例如 ， 如 下 的 <s:url> 将 会 演 染 HTML 转 义 后 的 URL: 


<s:url value="/spittles" htmlEscape="true"> 
<S:param name="max" value="60" /> 


<S:param name="count" value="20" /> 
</s:url> 





所 泻 染 的 URL 结 果 如 下 所 示 : 


/spitter/spittles?max=66&count=26 


另 一 方面 ， 如 果 你 希望 在 JavaScript 代 码 中 使 用 URL 的 话 ， 那 么 应 访 
将 javascript-Escape 属 性 设置 为 true: 





<S:Url value="/spittles" var="spittlesJSUrl" javaScriptEscape="true"> 
<S:param name="max" value="60" /> 


<S:param name="count”Vvalue="26”/> 
</s:url> 
<script> 

var spittlesUrl = "${spittlesjJSUrl}" 
</script> 





这 会 泻 染 如 下 的 结果 到 响应 之 中 : 


<script> 


var spittlesUrl = "\/spitter\/spittles?max=606&count=20" 
</script> 





既然 提 到 了 转 义 ， 有 一 个 标签 专门 用 来 转 义 内 容 ， 而 不 是 转 义 标签 。 接 
下 来 ， 让 我 们 看 一 下 。 
转 义 内 容 


<s:escapeBody> 标 签 是 一 个 通用 的 转 义 标签 。 它 会 泻 染 标签 体 中 内 髓 
的 内 容 ， 并 且 在 必要 的 时 候 进 行 转 义 。 

例如 ， 假 设 你 希望 在 页 面 上 展现 一 个 HTML 代 码 片段 。 为 了 正确 显示 ， 
我 们 需要 将 “<” 和 “>?” 字 符 葵 换 为 "&l1tj” 和 “&gt;j”， 人 否则 的 话 ， 浏 览 器 将 
会 像 解析 页 面 上 其 他 HIML 那 样 解析 这 段 HIML 内 容 。 

当然 ， 没 有 人 禁止 我 们 手动 将 其 转 义 为 “&1lt;” 和 “&gt;”， 但 是 这 很 烦 
琐 ， 并 且 代 码 难以 阅读 。 我 们 可 以 使 用 <s:escapeBody>， 并 让 Spring 
完成 这 项 任务 : 


<s:escapeBody htmlEscape="true"> 
<h1i>Hello</h1> 
</s:escapeBody> 


它 将 会 在 啊 应 体 中 演 染 成 如 下 的 内 容 : 


&lt;h1i&gt;Hello&lt;/hi&eget,; 


虽然 转 义 后 的 格式 看 起 来 很 难 读 ， 但 浏览 器 会 很 乐意 将 其 转换 为 未 转 义 
的 HIML， 也 惑 是 我 们 希望 用 户 能 够 看 到 的 样子 。 


通过 设置 javaScriptEscape 属 性 ，<s:escapeBody> 标 签 还 支持 








JavaScript 转 义 : 


<s:escapeBody javaScriptEscape="true"> 
<h1i>Hello</h1> 





</s:escapeBody> 





<s:escapeBody> 只 完成 一 件 事 ， 并 且 完 成 得 非常 好 。 与 <s:ur1> 不 
同 ， 它 只 会 泻 染 内 容 ， 并 不 能 将 内 容 设置 为 变量 。 


现在 ， 我 们 已 经 看 到 了 如 何 使 用 JSP 来 定义 Spring 视图 ， 现 在 让 我 们 考虑 
一 下 如 何 使 其 在 审美 上 更 加 有 吸引 力 。 我 们 可 以 在 页 面 上 增加 一 些 通 用 
的 元 素 ， 比 如 添加 包含 站 点 Logo 的 头 部 、 使 用 样式 并 在 底部 展现 版 权 信 
息 。 我 们 不 会 在 Spittr 应 用 中 的 每 个 JSP 都 进行 这 样 的 修改 ， 而 是 借助 
Apache Tiles 来 为 模板 实现 一 些 通用 且 可 重用 的 布局 。 





6.3 ”使 用 Apache Tiles 视 图 定义 布局 


到 现在 为 止 ， 我 们 很 少 关 心 应 用 中 Web 页 面 的 布局 问题 。 每 个 JSP 完 全 
负责 定义 上 自身 的 布局 ， 在 这 方面 其 实 这 些 JSP 也 没有 做 太 多 工作 。 


假设 我 们 想 为 应 用 中 的 所 有 页 面 定 义 一 个 通用 的 头 部 和 后 部 。 最 原始 的 
方式 束 是 俘 找 每 个 JSP 模 板 ， 并 为 其 添加 头 部 和 乓 部 的 HTML。 但 是 这 
种 方法 的 扩展 性 并 不 好 ， 也 难以 维护 。 为 每 个 页 面 添加 这 些 元 素 会 有 一 
些 初始 成 本 ， 而 后 续 的 每 次 变更 都 会 耗费 类 似 的 成 本 。 


更 好 的 方式 是 使 用 布局 引擎 ， 如 Apache Tiles， 定 义 适用 于 所 有 页 面 的 
通用 页 面 布局 。Spring MVC 以 视图 解析 器 的 形式 为 Apache Tiles 提 供 了 
文 持 ， 这 个 视图 解析 器 能 够 将 逻辑 视图 名 解析 为 Tile 定 义 。 


6.3.1 配置 Tiles 视 图 解析 器 


为 了 在 Spring 中 使 用 Tiles， 需 要 配置 几 个 bean。 我 们 需要 一 

个 TilesConfigurer bean， 它 会 负 贡 定位 和 加 载 Tile 定 义 并 协调 生成 
Tiles。 除 此 之 外 ， 还 需要 TilesViewResolver bean 将 逻辑 视图 名 称 解 
析 为 Tile 定 义 。 

这 两 个 组 件 又 有 两 种 形式 : 针对 Apache Tiles 2 和 Apache Tiles 3 分 别 都 有 
这 么 两 个 组 件 。 这 两 组 Tiles 组 件 之 间 最 为 明显 的 区 别 在 于 包 名 。 针 对 
Apache Tiles 2 的 TilesConfigurer/TilesViewResolver 位 于 
org.springframework.web.servlet.view.tiles2 包 中 ， 而 针对 
Tiles 3 的 组 件 位 于 


org.springframework.web.servlet.view.tiles3 包 中 。 对 于 该 例 
子 来 讲 ， 假 设 我 们 使 用 的 是 Tiles 3。 


首先 ， 配 置 TilesConfigurer 来 解析 Tile 定 义 。 
程序 清单 6.1 配置 TilesConfigurer 来 解析 定义 























指定 Tile 定义 的 位 置 





si? 
tiles.setCheckRefresh(true) ; 启用 刷新 功能 


当 配 置 TilesConfigurer 的 时 候 ， 所 要 设置 的 最 重要 的 属性 就 
是 definitions。 这 个 属性 接受 一 个 string 类 型 的 数组 ， 其 中 每 个 条 
目 都 指定 一 个 Tile 定 义 的 XML 文件 。 对 于 Spittr 应 用 来 讲 ， 我 们 让 它 
在 “WEB-INF/layout/”* 目 录 下 查找 tiles.xml。 


其 实 我 们 还 可 以 指定 多 个 Tile 定 义 文件 ， 甚 至 能 够 在 路 径 位 置 上 使 用 通 
配 符 ， 当 然 在 上 例 中 我 们 没有 使 用 该 功能 。 例 如 ， 我 们 要 
求 TilesConfigurer 加 载 “%4WEB-INF/” 目 录 下 的 所 有 名 字 为 tiles.xml 的 
文件 ， 那 么 可 以 按照 如 下 的 方式 设置 definitions 属 性 : 


tiles.setDefinitions(new String[] { 
"/WEB-INF/**/tiles.xml" 
}); 


tiles.setDefinitions(new String[] { 


"/WEB-INF/**/tiles.xml" 
}); 


在 本 例 中 ， 我 们 使 用 了 Ant 风 格 的 通配符 (**) ， 所 以 
TilesConfigurer 会 遍历 “WEB-INEF/ 的 所 有 子 目录 来 查找 Tile 定 义 。 


接 下 来 ， 让 我 们 来 配置 TilesViewResolver， 可 以 看 到 ， 这 是 一 个 很 
基本 的 bean 定 义 ， 没 有 什么 要 设置 的 属性 : 





Q@Bean 
public ViewResolver viewResolver() 1{ 
return new TilesViewResolver(); 


} 


@Bean 
public ViewResolver viewResolver() { 


return new TilesViewResolver(); 


} 





如 采 你 更 喜欢 XML 配置 的 话 ， 那 么 可 以 按照 如 下 的 形式 配 


置 TilesConfigurer 和 TilesViewResolver: 


<bean id="tilesConfigurer" class= 
"org.springframework.web.servilet.view.tiles3.TilesConfigurer"> 
<property name="definitions"> 
<list> 
<value>/WEB-INF/layout/tiles.xml .xml</value> 
<value>/WEB-INF/views/**/tiles.xml</value> 
</list> 
</property> 
</bean> 


<bean id="viewResolver" class= 
"org.springframework.web.servilet.view.tiles3.TilesViewResolver" /> 


<bean id="tilesConfigurer" class= 
"org.springframework .web.servlet.view.tiles3.TilesConfigurer"> 
<property name="definitions"> 
<list> 
<value>/WEB-INF/layout/tiles.xml.xml</value> 


<value>/WEB-INF/views/**/tiles.xml</value> 
</list> 
</property> 
</bean> 
<bean id="viewResolver" class= 
"org.springframework .web.servlet.view.tiles3.TilesViewResolver" /> 





TilesConfigurer 会 加 载 Tile 定 义 并 与 Apache Tiles 协 作 ， 

而 TilesViewRe-solver 会 将 逻辑 视图 名 称 解析 为 引用 Tile 定 义 的 视 
图 。 它 是 通过 查找 与 逻辑 视图 名 称 相 [ 匹 配 的 Tile 定 义 实现 该 功能 的 。 我 
们 需要 创建 几 个 Tile 定 义 以 了 解 它 是 如 何 运 转 的 。 

定义 Tiles 

Apache Tiles 提 供 了 一 个 文档 类 型 定义 〈document type definition ， 

DTD) ， 用 来 在 XML 文件 中 指定 Tile 的 定义 。 每 个 定义 中 需要 包含 一 个 
<definition> 元 素 ， 这 个 元 素 会 有 一 个 或 多 个 <cput-attribute> 元 
素 。 例 如 ， 如 下 的 XML 文档 为 Spittr 应 用 定义 了 几 个 Tile。 


程序 清单 6.2 为 Spittr 应 用 定义 Tile 


<?xml version="1.0" encoding="ISO-8859-1" ?> 
<!DOCTYPE tiles-definitions PUBLIC 
"-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN" 
"http://tiles.apache.org/dtds/tiles-config_ 3_0.dtd"> 
<tiles-definitions> 


定义 base Tile 


<definition name="base" 1 
template="/WEB-INF/layout/page.jsp"> 
<put-attribute name="header" 
value="/WEB-INF/layout/header.jsp" /> 
<put-attribute name="footer" 
value="/WEB-INF/layout/footer.jsp" /> < 一 设置 属性 
</definition> 


<definition name="home'" extends="base"> 二 一 扩展 base Tile 
<put-attribute name="body" 
value="/WEB-INF/views/home.jsp" /> 
</definition> 
<definition name="registerForm" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/registerForm.jsp" /> 
</definition> 


<definition name="profile" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/profile.jsp" /> 
</definition> 


<definition name="spittles" extends="base"> 
<put-attribute name="body" 
value="/WEB-INF/views/spittles.jsp" /> 
</definition> 


<definition name="spittle'" extends="base'"> 
<put-attribute name="body" 
value="/WEB-INF/views/spittle.jsp" /> 
</definition> 


</tiles-definitions> 


每 个 <definition> 元 素 都 定义 了 一 个 Tile， 它 最 终 引 用 的 是 一 个 JSP 模 
板 。 在 名 为 base 的 Tile 中 ， 模 板 引 用 的 是 “/WEB-INF/layout/page.jsp”。 
某 个 Tile 可 能 还 会 引用 其 他 的 JSP 模 板 ， 使 这 些 JSP 模 板 仍 入 到 主 模板 
对 于 base Tile 来 讲 ， 它 引用 的 是 一 个 头 部 JSP 模 板 和 一 个 底部 JSP 模 


base Tile 所 引用 的 page.jsp 模 板 如 下 面 程序 清单 所 示 。 
程序 清单 6.3 主 布局 模板 : 引用 其 他 模板 来 创建 视图 


<%@ taglib uri="http://www.springframework.org/tags" prefix="s" 向 > 
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="t" 名 > 
<%@ page session="false" $%> 
<html> 

<head> 


<title>Spittr</title> 


<link rel="stylesheet" 
type="text/css" 
href="<s:url value="/resources/style.css" />" > 
</head> 
<body> 


<div id="header"> 


<t:insertAttribute name="header" /> 插入 头 部 
</Adiv> 


<div id="*content"> 


<t:insertAttribute name="body" /> 插入 主体 内 容 
</div> 
<div id="footer"> 
: 人 
<t:insertAttribute name="footer" /> : 插入 底部 
</div> 


</body> 
</htmil> 


在 程序 清单 6.3 中 ， 需 要 重点 关注 的 事情 就 是 如 何 使 用 Tile 标 签 库 中 的 
<t:insert Attribute> JSP 标 签 来 插入 其 他 的 模板 。 在 这 里 ， 用 它 来 
插入 名 为 header、body 和 footer 的 模板 。 最 终 ， 它 会 形成 图 6.4 所 示 的 
布局 。 





合生 后 Spittr we 


[号 | http: /localhost:g080/spittr/ © | | 天 [ 避 ] 








图 6.4 通用 的 布局 ， 定 义 了 头 部 、 主 体 区 以 及 底部 


在 base Tile 定 义 中 ，header 和 footer 属 性 分 别 被 设置 为 引用 “/WEB- 
INF/layout/ header. jsp” 和 “/WEB-INF/layout/footer.jsp”。 但 是 body 属 性 


呢 ? 它 是 在 哪里 设置 的 呢 ? 


在 这 里 ，base Tile 不 会 期 望 单独 使 用 。 它 会 作为 基础 定义 〈 这 是 其 名 字 
的 来 历 ) ， 供 其 他 的 Tile 定 义 扩 展 。 在 程序 清单 6.2 的 其 余 内 容 中 ， 我 们 
可 以 看 到 其 他 的 Tile 定 义 都 是 扩展 自 base Tile。 它 意味 着 它们 会 继承 
其 header 和 footer 属 性 的 设置 〈 当 然 ，Tile 定 义 中 也 可 以 履 盖 掉 这 些 属 
， 但 是 每 一 个 都 设置 了 body 属 性 ， 用 来 指定 每 个 Tile 特 有 的 JSP 模 


现在 ， 我 们 关注 一 下 home Tile， 它 扩展 了 base。 因 为 它 扩展 了 base， 
因此 它 会 继承 base 中 的 模板 和 所 有 的 属性 。 尽 管 home Tile 定 义 相 对 来 
说 很 简单 ， 但 是 它 实 际 上 包含 了 如 下 的 定义 : 





<definition name="home" template="/WEB-INF/layout/page.jsp"> 
<put-attribute name="header" value="/WEB-INF/layout/header.jsp" /> 


<put-attribute name="footer" value="/WEB-INF/layout/footer.jsp" /> 
<put-attribute name="body" value="/WEB-INF/views/home.jsp”" /> 
</definition> 








属性 所 引用 的 每 个 模板 是 很 简单 的 ， 如 下 是 header.jsp 模 板 : 


<%Q@ taglib uri="http://www.springframework.org/tags" prefix="s" %> 
<a href="<s:url value="/" />"><img 
src="<s:Uurl] value="/resources" />»/images/spittr_ logo 56.png" 
border="0"/></a> 


footer.jsp 模 板 更 为 简单 : 


每 个 扩展 自 base 的 Tile 都 定义 了 自己 的 主体 区 模板 ， 所 以 每 个 都 会 与 其 
他 的 有 所 区 别 。 但 是 为 了 完整 地 了 解 home Tile， 如 下 展现 了 home.jsp: 





<%Q@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %> 
<X%Q@ page session="false" %> 
<hi>Welcome to Spittr</h1> 


«a href="<c:url value="/spittles" />">Spittles</a> | 
<a href="<c:url value="/spitter/register" />">Register</a> 





这 里 的 关键 点 在 于 通用 的 元 素 放 到 了 page.jsp、header.jsp 以 及 footer.jsp 
中 ， 其 他 的 Tile 模 板 中 不 再 包含 这 部 分 内 容 。 这 使 得 它们 能 够 跨 页 面 重 
用 ， 这 些 元 素 的 维护 也 得 以 简化 。 


要 想 看 一 下 这 些 元 素 组 合 在 一 起 的 样子 ， 那 么 可 以 看 一 下 图 6.5。 如 图 
所 示 ， 它 包含 了 一 些 样式 和 图 像 以 增加 应 用 的 美观 性 。 我 们 不 是 专门 讨 
论 使 用 Tiles 实 现 页 面 布局 的 ， 因 此 在 本 节 中 不 会 涵盖 所 有 的 细节 。 但 
是 ， 我 们 可 以 看 到 页 面 上 的 各 种 组 件 通过 Tile 定 义 组 合 在 了 一 起 ， 并 且 
泻 染 出 了 Spittr 应 用 的 主页 。 


在 Java Web 应 用 领域 ，JSP 长 期 以 来 都 是 占据 主导 地 位 的 方案 。 但 是 ， 
在 这 个 领域 有 了 新 的 竞争 者 ， 也 就 是 Thymeleaf。 接 下 来 让 我 们 看 一 下 
如 何在 Spring MVC 应 用 中 使 用 Thymeleaf。 








图 6.5” ”Spittr 首 页 ， 通 过 Apache Tiles 进 行 的 布局 


6.4 使 用 Thymeleaf 


尽管 JSP 已 经 存在 了 很 长 的 时 间 ， 并 且 在 Java Web 服 务 器 中 无 处 不 在 ， 

但 是 它 却 存在 一 些 缺 陷 。JSP 最 明显 的 问题 在 于 它 看 起 来 像 HITML 或 
XML， 但 它 其 实 上 并 不 是 。 大 多 数 的 JSP 模 板 都 是 采用 HTML 的 形式 ， 
但 是 又 摊 杂 上 了 各 种 JSP 标 签 库 的 标签 ， 使 其 变 得 很 混乱 。 这 些 标签 库 
能 够 以 很 便利 的 方式 为 JSP 带 来 动态 泻 染 的 强大 功能 ， 但 是 它 也 摧毁 了 
我 们 想 维持 一 个 格式 良好 的 文档 的 可 能 性 。 作 为 一 个 极端 的 样 例 ， 如 下 
的 JSP 标 签 甚至 作为 HTML 参 数 的 值 : 





<input type="text" value="<c:out value="${thing.name}"/>" /> 


标签 库 和 JSP 缺 乏 良 好 格式 的 一 个 副作用 就 是 它 很 少 能 够 与 其 产生 的 
HTML 类 似 。 所 以 ， 在 Web 浏览 器 或 HTML 编辑 器 中 查看 未 经 泻 染 的 JSP 
模板 是 非常 令 人 困惑 的 ， 而 且 得 到 的 结果 看 上 去 也 非常 丑陋 。 这 个 结果 
是 不 完整 的 一 一 在 视觉 上 这 简直 就 是 一 场 灾难 ! 因为 JSP 并 不 是 真正 的 
HTML， 很 多 浏览 器 和 编辑 器 展现 的 效果 都 很 难 在 审美 上 接近 模板 最 终 
所 泻 染 出 来 的 效果 。 


同时 ，JSP 规 范 是 与 Servlet 规 范 紧 密 耦 合 的 。 这 意味 着 它 只 能 用 在 基于 
Servlet 的 Web 应 用 之 中 。JSP 模 板 不 能 作为 通用 的 模板 〈 如 格式 化 
Email) ， 也 不 能 用 于 非 Servlet 的 Web 应 用 。 


多 年 来 ， 在 Java 应 用 中 ， 有 多 个 项 目 试图 挑战 JSP 在 视图 领域 的 统治 性 
地 位 。 最 新 的 挑战 者 是 Thymeleaf， 它 展现 了 一 些 切实 的 承诺 ， 是 一 项 
很 令 人 兴奋 的 可 选 方案 。Thymeleaf 模 板 是 原生 的 ， 不 依赖 于 标签 库 。 
它 能 在 接受 原始 HTML 的 地 方 进 行 编辑 和 演 染 。 因 为 它 没 有 与 Servlet 规 
范 耦 合 ， 因 此 Thymeleaf 模 板 能 够 进入 JSP 所 无 法 涉足 的 领域 。 现 在 ， 我 
们 看 一 下 如 何在 Spring MVC 中 使 用 Thymeleaf。 


6.4.1 配置 Thymeleaf 视 图 解析 器 


为 了 要 在 Spring 中 使 用 Thymeleaf， 我 们 需要 配置 三 个 启用 Thymeleaf 与 
Spring 集成 的 bean: 


。 ThymeleafViewResolver: 将 逻辑 视图 名 称 解 析 为 Thymeleaf 模 板 








视图 ; 
。SpringTemplateEngine: 处 理 模板 并 泻 染 结 
。TemplateResolver: 加 载 Thymeleaf 模 板 。 


如 下 为 声明 这 些 bean 的 Java 配 置 。 
程序 清单 6.4 ”使 用 Java 代 码 的 方式 ， 配 置 Spring 对 Thymeleaf 的 支持 


@Bean 
public ViewResolver viewResolver( Thymeleaf 视图 解析 器 
SpringTemplateEngine templateEngine) { 
ThymeleafViewResolver viewResolver = new ThymeleafViewResolver!(); 
ViewResolver .setTemplateEngine (templateEngine); 
return viewResolver; 
} 


@Bean 
public TemplateEngine templateEngine!{ -一 模板 引擎 
TemplateResolver templateResolver) { 
SpringTemplateEngine templateEngine = new SpringTemplateEngine!{(); 
templateEngine.setTemplateResolver (templateResolver); 


return templateEngine; 
} 


@Bean 

public TemplateResolver templateResolver() { 模板 解析 器 
TemplateResolver templateResolver = 

new ServletContextTemplateResolver!{(); 

templateResolver.setPrefix{"/WEB-INF/templates/"); 
templateResolver.setSuffix{".html"); 
templateResolver.setTemplateMode ("HTMLS"); 
return templateResolver; 


如 果 你 更 愿意 使 用 XML 来 配置 bean， 那 么 如 下 的 <bean> 声 明 能 够 完成 
该 任务 。 


程序 清单 6.5 使 用 XML 的 方式 ， 配 置 Spring 对 Thymeleaf 的 支持 


<bean id="viewResolver" < Thymeleaf 视图 解析 器 
class=*org.thymeleaf .spring3.view.ThymeleaftViewResolver'" 
p:templateEngine-ref="templateEngine" /> 


<bean id="templateEngine" 3 模板 引擎 
class="org.thymeleaf.spring3.SpringTemplateEngine" 
p:templateResolver-ref="templateResolver" /> 


<bean id="templateResolver" class= ,| 模板 解析 器 
"org.thymeleaf.templateresolver.ServletContextTemplateResolver'" 
p:prefix="/WEB-INF/templates/" 
Diauiffixe" .html" 
p:templateMode="HTMLS" /> 


不 管 使 用 哪 种 配置 方式 ，Thymeleaf 都 已 经 准备 就 绕 了 ， 它 可 以 将 响应 


中 的 模板 演 染 到 Spring MVC 控 制 器 所 处 理 的 请 求 中 。 


ThymeleafViewResolver 是 Spring MVC 中 ViewResolver 的 一 个 实现 
类 。 像 其 他 的 视图 解析 右 一 样 ， 它 会 接受 一 个 逻辑 视图 名 称 ， 并 将 其 解 
析 为 视图 。 不 过 在 该 场景 下 ， 视 图 会 是 一 个 Thymeleaf 模 板 。 


需要 注意 的 是 ThymeleafViewResolver bean 中 注入 了 一 个 对 
SpringTemplate Engine bean 的 引用 。SpringTemplateEngine 会 在 
Spring 中 启用 Thymeleaf 引 苟 ， 用 来 解析 模板 ， 并 基于 这 些 模板 泻 染 结 
果 。 可 以 看 到 ， 我 们 为 其 注入 了 一 个 TemplateResolver bean 的 引用 。 


TemplateResolver 会 最 终 定位 和 查找 模板 。 与 之 前 配 

置 InternalResource-ViewResolver 类 似 ， 它 使 用 了 prefix 和 
suffix 属 性 。 前 级 和 后 级 将 会 与 风 辑 视图 名 组 合 使 用 ， 进 而 定位 
Thymeleaf 引 擎 。 它 的 templateMode 属 性 被 设置 成 了 HTML 5， 这 表明 
我 们 预期 要 解析 的 模板 会 泻 染 成 HTML 5 输出 。 


所 有 的 Thymeleaf bean 都 已 经 配置 完成 了 ， 那 么 接 下 来 我 们 该 创建 几 个 
视图 了 。 














6.4.2 ”定义 Thymeleaf 模 板 


Thymeleaf 在 很 大 程度 上 就 是 HTML 文 件 ， 与 JSP 不 同 ， 它 没有 什么 特殊 
的 标签 或 标签 库 。Thymeleaf 之 所 以 能 够 发 挥 作用 ， 是 因为 它 通 过 自 定 
义 的 命名 空间 ， 为 标准 的 HTML 标 签 集合 添加 Thymeleaf 属 性 。 如 下 的 程 
序 清单 展现 了 home.html， 也 束 是 使 用 Thymeleaf 命 名 空间 的 首页 模板 。 


程序 清单 6.6”home.html: 使 用 Thymeleaf 命 名 空间 的 首页 模板 引擎 


<html xmlns="http://www.w3.0org/1999/xhtml" 
xmlns:th="http://www.thymeleaf .org"> 声明 Thymeleaf 命名 空间 
<head> 
<title>Spittr</title> 
<link rel="stylesheet" 





De©= Le 与 
th:href="@{/resources/style.css}"></link> 到 样式 表 的 th:href 链接 


tles}">Spittles</a> 到 页 面 的 th:href 链接 
r}">Reai r</a> 








首页 模板 相对 来 讲 很 简单 ， 只 使 用 了 th : href 属性。 这 个 属性 与 对 应 的 
原生 HTML 属 性 很 类 似 ， 也 就 是 href 属性 ， 并 且 可 以 按照 相同 的 方式 来 
使 用 。th:href 属 性 的 特殊 之 处 在 于 它 的 值 中 可 以 包含 Thymeleaf 表 达 

式 ， 用 来 计算 动态 的 值 。 它 会 泻 染 成 一 个 标准 的 href 属 性 ， 其 中 会 包含 
在 泻 染 时 动态 创建 得 到 的 值 。 这 是 Thymeleaf 命 名 空间 中 很 多 属性 的 运 

行 方式 : 它们 对 应 标准 的 HTML 属 性 ， 并 且 具 有 相同 的 名 称 ， 但 是 会 演 
染 一 些 计 算 后 得 到 的 值 。 在 本 例 中 ， 使 用 th:href 属 性 的 三 个 地 方 都 用 
到 了 “@{}” 表 达 式 ， 用 来 计算 相对 于 URL 的 路 径 〔 就 像 在 JSP 页 面 中 ， 我 
们 可 能 会 使 用 的 JSTL <c:ur1> 标 签 或 Spring<s:ur1> 标 签 类 似 ) 。 


尽管 home.html 是 一 个 相当 简单 的 Thymeleaf 模 板 ， 但 是 它 依 然 很 有 价 
值 ， 这 在 于 它 与 纯 HTML 模 板 非常 接近 。 唯 一 的 区 别 之 处 在 于 th:href 
属性 ， 否 则 的 话 ， 它 就 是 基础 昌 功 能 丰 定 的 HTML 文 件 。 


这 意味 着 Thymeleaf 模 板 与 JSP 不 同 ， 它 能 够 按照 原始 的 方式 进行 编辑 其 
至 泻 染 ， 而 不 必 经 过 任何 类 型 的 处 理 器 。 当 然 ， 我 们 需要 Thymeleaf 来 
处 理 模 板 并 泻 染 得 到 最 终 期 望 的 输出 。 即 便 如 些 ， 如 果 没 有 任何 特殊 的 
处 理 ，home.html 也 能 够 加 载 到 Web 浏 览 器 中 ， 并 且 看 上 去 与 完整 泻 染 的 
效果 很 类 似 。 为 了 更 加 清晰 地 曾 述 这 一 点 ， 图 6.6 对 比 了 home.jsp (上 
方 ) 和 home.html〈 下 方 ) 在 web 浏览 器 中 的 显 式 效果 。 


可 以 看 到 ， 在 Web 浏 览 右 中 ，JSP 模 板 的 演 染 效果 很 糟 糙 。 尽 管 我 们 可 
以 看 到 一 些 熟 悉 的 元 素 ， 但 是 JSP 标 签 库 的 声明 也 显示 了 出 来 。 在 链接 
前 出 现 了 一 些 令 人 费解 的 未 闭合 标记 ， 这 是 Web 浏览 器 没有 正常 解析 
<s:Url> 标 签 的 结 


与 之 相反 ，Thymeleaf 模 板 的 泻 染 效果 基本 上 没有 任何 错误 。 稍 微 有 点 
问题 的 是 链接 部 分 ，Web 浏 览 右 并 不 会 像 处 理 href 属 性 那样 处 

理 th:href， 所 以 链接 并 没有 泻 染 为 链接 的 样子 。 除 了 这 些 细微 的 问 
题 ， 模 板 的 演 染 效果 与 我 们 的 预期 完全 符合 。 

像 home.jsp 这 样 的 模板 作为 Thymeleaf 入 门 是 很 合适 的 。 但 是 Spring 的 JSP 


标签 所 擅长 的 是 表单 绑 定 。 如 果 我 们 抛弃 JSP 的 话 ， 那 是 不 是 也 要 抛弃 
表单 绑 定 呢 ? 不 必 担 心 。Thymeleaf 提 供 了 与 之 相 匹 敌 的 功能 。 
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图 6.6 ”Thymeleaf 模 板 与 JSP 不 同 ， 它 是 HTML， 
可 以 像 HTML 那 样 进行 泻 染 和 编辑 


借助 Thymeleaf 实 现 表 单 绑 定 


表单 绑 定 是 Spring MVC 的 一 项 重要 特性 。 它 能 够 将 表单 提交 的 数据 填充 
到 命令 对 象 中 ， 并 将 其 传递 给 控制 器 ， 而 在 展现 表单 的 时 候 ， 表 单 中 也 
会 填充 命令 对 象 中 的 值 。 如 果 没 有 表单 绑 定 功能 的 话 ， 我 们 需要 确保 
ee ee es) 后 端 命令 对 象 中 的 属性 ， 并 且 在 校 验 失败 后 展现 表 
单 的 时 候 ， 还 要 负 贡 确保 输入 域 中 值 要 设置 为 命令 对 象 的 属性 。 


但 是 ， 如 果 有 表单 绑 定 的 话 ， 它 就 会 负责 这 些 事情 了 。 为 了 复习 一 下 表 
单 绑 定 是 如 何 运 行 的 ， 下 面 展现 en jsp 中 的 First Name 输 入 
域 ; 



























































<sf:label path="firstName" 


cssErrorClass="error">First Name</sf:1label>: 
<sf:input path="firstName" cssErrorClass="error" /><br/> 





在 这 里 ， 调 用 了 Spring 表 单 绑 定 标签 库 的 <sf:input> 标 签 ， 它 会 泻 染 出 
一 个 HTML <input> 标 签 ， 并 且 其 value 属 性 设置 为 后 端 对 

象 firstName 属 性 的 值 。 它 还 使 用 了 Spring 的 <sf:1abel> 标 签 
ee 如 果 出 现 校 验 错误 的 话 ， 六 闪 文本 标 包 党 染 拉 为 
红色 。 


但 是 ， 我 们 本 节 讨 论 的 并 不 是 JSP， 而 是 使 用 Thymeleaf 蔡 换 JSP。 


此 ， 我 们 不 能 使 用 Spring 的 JSP 标 俭 实 现 表 单 绑 定 ， 而 是 使 用 Thymeleaf 
的 Spring 方言 。 


作为 阐述 的 样 例 ， 请 参考 如 下 的 Thymeleaf 模 板 片 段 ， 它 会 泻 染 First 
Name 输 入 域 : 


<label th:class="${#fields.hasErrors('firstName')}? 'error'"> 
First Name</label>: 


<input type="text" th:field="*{firstName}" 
th:class="${#fields.hasErrors('firstName')}? 'error'" /><br/> 





在 这 里 ， 我 们 不 再 使 用 Spring JSP 标 签 中 的 cssClassName 属 性 ， 而 是 在 
标准 的 HTML 标签 上 使 用 th:class 属 性 。th:class 属 性 会 泻 染 为 一 
个 class 属 性 ， 它 的 值 是 根据 给 定 的 表达 式 计算 得 到 的 。 在 上 面 的 这 两 
个 th:class 属 性 中 ， 它 会 直接 检查 firstName 域 有 没有 校 验 错误 。 如 
果 有 的 话 ， 和 打 时 的 值 为 error。 如 果 这 个 域 没 有 错误 的 
话 ， 将 不 会 泻 染 class 属 性 。 


<input> 标 签 使 用 了 th:field 属 性 ， 用 来 引用 后 端 对 象 的 firstName 
域 。 这 可 能 与 你 的 预期 有 点 差别 。 在 Thymeleaf 模 板 中 ， 我 们 在 很 多 情 
况 下 所 使 用 的 属性 都 对 应 于 标准 的 HTML 属 性 ， 因 此 貌似 使 

用 th :value 属 性 来 设置 <input> 标 签 的 value 属 性 才 是 合理 的 。 


其 实 不 然 ， 因 为 我 们 是 在 将 这 个 输入 域 绑 定 到 后 端 对 象 的 FirstName 属 
性 上 ， 因 此 使 用 th:field 属 性 引用 firstName 域 。 通 过 使 

用 th:field， 我 们 将 value 属 性 设置 为 firstName 的 值 ， 同 时 还 会 
将 name 属 性 设置 为 firstName。 


为 了 阐述 Thymeleaf 是 如 何 实际 运行 的 ， 如 下 的 程序 清单 展示 了 完整 的 
注册 表单 模板 。 


程序 清单 6.7 注册 页 面 ， 使 用 Thymeleaf 将 一 个 表单 绑 定 到 命令 对 象 
< 











<form method="POST" th:object="${spitter}"> 


<div class="errors" th:if="${#fields.hasErrors('*')}"> 





1 
展示 错误 
ul> 
<li th:each="err : S${#fields.errors('*')}" 
th:text="$ {err}">Input is incorrect</1i> 
/ul 
< 
FirstName <labe Error irstName ? 'error 
1r ame} 
fields.hasErrors('firstName')}? 'error'’'" /><br/: 
<label th:class="${#fields.hasErrors('lastName’'}}? ‘error'"> 


Last Name 


Last Name</label>: 


<input type="text" th:field="*{lastName}" 





th:class="${#fields.hasBrrors('lastName')}? 'error'" /><br/: 
Email <label th:class="${#fields.hasErrors('email')}? ‘error'"> 
Email</label>: 
<input type="text" th:field="*{email}" 


th:class="${#fields.hasErrors('email')}? ‘error'" /><br/> 


Username <label th:class="${#fields.hasErrors('username’'}}? ‘error'"> 


Username</label>: 







" th:fieid="*{uSername}" 


${#fieilds.hasErrors('username')}? ‘error'" /><br/> 





Password {#fields.hasErrors('password')}? '‘'err 
rad" th:field= 
'S{#fields.nasErrors{' } or' > 





程序 清单 6.7 使 用 了 相同 的 Thymeleaf 属 性 和 “*{}” 表 达 式 ， 为 所 有 的 表单 
域 绑 定 后 端 对 象 。 这 其 实 重复 了 我 们 在 First Name 域 中 所 做 的 事情 。 


但 是 ， 需 要 注意 我 们 在 表单 的 项 部 了 也 使 用 了 Thymeleaf， 它 会 用 来 泻 
染 所 有 的 错误 。<div> 元 素 使 用 th:if 属 性 来 检查 是 否 有 校 验 错误 。 如 
果 有 的 话 ， 会 泻 染 <div>， 否 则 的 话 ， 它 将 不 会 泻 染 。 


在 <div> 中 ， 会 使 用 一 个 无 顺序 的 列表 来 展现 每 项 错误 。<1i> 标 签 上 的 
th:each 属 性 将 会 通知 Thymeleaf 为 每 项 错误 都 泻 染 一 个 <l1i>， 在 每 次 
友 代 中 会 将 当前 错误 设置 到 一 个 名 为 err 的 变量 中 。 


<1i> 标 签 还 有 一 个 th :text 属 性 。 这 个 命令 会 通知 Thymeleaf 计 算 某 一 
个 表达 式 〈 在 本 例 中 ， 也 就 是 err 变 量 ) 并 将 它 的 值 泻 染 为 <11> 标 签 的 
~ 实际 上 的 效果 就 是 每 项 错误 对 应 一 个 <1i> 元 素 ， 并 展现 错误 的 
es 

你 可 能 会 想 知 道 “${}” 和 “*{}” 括 起 来 的 表达 式 到 底 有 什么 区 

别 。“${}” 表 达 式 (如 ${spitter}) 是 变量 表达 式 (variable 





























expression) 。 一 般 来 讲 ， 它 们 会 是 对 象 图 导航 语言 (Object-Graph 
Navigation Language，OGNL ) 表达 式 
(http://commons.apache.org/proper/commons-ognl/) 。 但 在 使 用 Spring 的 
时 候 ， 它 们 是 SpEL 表 达 式 。 在 ${spitter} 这 个 例子 中 ， 它 会 解析 为 
key 为 spitter 的 model 属 性 。 


而 对 于 “*{}” 表 达 式 ， 它 们 是 选择 表达 式 (selection expression) 。 变 量 
表达 式 是 基于 整个 SpEL 上 下 文 计算 的 ， 而 选择 表达 式 是 基于 某 一 个 选 
中 对 象 计算 的 。 在 本 例 的 表单 中 ， 选 中 对 象 就 是 <form> 标 签 中 
th:object 属 性 所 设置 的 对 象 : 模型 中 的 Spitter 对 象 。 因 此 ，“* 
{firstName}” 表 达 式 就 会 计算 为 Spitter 对 象 的 位 rstName 属 性 。 


6.5 小结 


处 理 请 求 只 是 Spring MVC 功 能 的 一 部 分 。 如 果 控 制 器 所 产生 的 结果 想 要 
让 人 看 到 ， 那 么 它们 产生 的 模型 数据 就 要 泻 染 到 视图 中 ， 并 展现 到 用 户 
的 Web 浏 览 器 中 。Spring 的 视图 泻 染 是 很 灵活 的 ， 并 提供 了 多 个 内 置 的 
可 选 方 案 ， 包 括 传 统 的 JavaServer Pages 以 及 流行 的 Apache Tiles 布 局 引 

列 久 


手 -o 


在 本 章 中 ， 我 们 首先 快速 了 解 了 一 下 Spring 所 提供 的 视图 和 视图 解析 可 
选 方案 。 我 们 还 深入 学 习 了 如 何在 Spring MVC 中 使 用 JSP 和 Apache 
Tiles。 


我 们 还 看 到 了 如 何 使 用 Thymeleaf 作 为 Spring MVC 应 用 的 视图 层 ， 它 被 
视 为 JSP 的 替代 方案 。Thymeleaf 是 一 项 很 有 吸引 力 的 技术 ， 因 为 它 能 创 
建 原始 的 模板 ， 这 些 模板 是 纯 HTML， 能 像 静 态 HTML 那 样 以 原始 的 方 
式 编写 和 预览 ， 并 且 能 够 在 运行 时 泻 染 动态 模型 数据 。 除 此 之 外 ， 
en a i 的 ， 这 样 它 就 能 够 用 在 JSP 所 不 能 使 
用 的 领域 中 。 


Spittr 应 用 的 视图 定义 完成 之 后 ， 我 们 已 经 具有 了 一 个 虽然 微小 但 是 可 
部 署 且 具有 一 定 功能 的 Spring MVC Web 应 用 。 还 有 一 些 其 他 的 特性 需 
要 更 新 进来 ， 如 数据 持久 化 和 安全 性 ， 我 们 会 在 合适 的 时 候 关 注 这 些 特 
性 。 但 现在 ， 这 个 应 用 开始 变 得 有 模 有 样 了 。 


在 深入 学 习 应 用 的 技术 栈 之 前 ， 在 下 一 章 我 们 将 会 继续 讨论 Spring 
MVC， 学 习 这 个 框架 中 一 些 更 为 有 用 和 高 级 的 功能 。 











第 7 章 ”Spring MVC 的 高 级 技术 
本 章 内 容 ， 


。 Spring MVC 配 置 的 蔡 代 方案 
。 处 理 文件 上 传 

。 在 控制 器 中 处 理 异常 

。 使 用 flash 属 性 


稍 等 ， 还 没有 结束 ! 


如 果 你 在 电视 购物 节目 上 看 过 一 些小 发 明 或 产品 广告 的 话 ， 你 可 能 听 过 
类 似 这 样 的 话 。 在 广告 描述 完 产 品 并 宣称 它 能 够 做 什么 之 后 ， 我 们 可 能 
会 昕 到 “ 稍 等 ， 还 没有 结束 ! ”， 然 后 广告 会 继续 告诉 我 们 产品 还 有 什么 
令 人 激动 的 特性 。 


在 很 多 方面 ，Spring MVC 《其 实 ， 整 个 Spring 也 是 如 此 ) 也 有 “还 没有 
结束 ! ”这 样 的 感觉 。 就 在 我 们 觉得 已 经 掌握 了 Spring MVC 能 够 做 什么 
之 后 ， 我 们 会 发 现 它 所 能 做 的 还 不 止 如 此 。 


在 第 5 章 中 ， 我 们 学 习 了 Spring MVC 的 基础 知识 ， 以 及 如 何 编 写 控制 器 
来 处 理 各 种 请 求 。 基 于 这 些 知识 ， 我 们 在 第 6 章 学 习 了 如 何 创 建 JSP 和 

Thymeleaf 视 图 ， 这 些 视 图 会 将 模型 数据 展现 给 用 户 。 你 可 能 认为 我 们 
己 经 掌握 了 Spring MVC 的 全 部 知识 。 但 是 稍 等 ! 还 没有 结束 ! 


在 本 章 中 ， 我 们 会 继续 Spring MVC 的 话题 ， 本 章 所 介绍 的 特性 已 经 超出 
了 第 5 章 和 第 6 章 基 础 知识 的 范畴 。 我 们 将 会 看 到 如 何 编写 控制 堪 来 处 理 
文件 上 传 、 如 何 处 理 控 制 器 所 抛 出 的 异常 ， 以 及 如 何在 模型 中 传递 数 
据 ， 使 其 能 够 在 重 定 问 (redirect) 之 后 依然 存活 。 


但 首先 ， 我 要 部 现 一 个 承诺 。 在 第 5 章 中 ， 我 快速 展现 了 如 何 通过 
AbstractAnnotationConfigDispatcherServletInitializer 搭 建 
Spring MVC， 当 时 我 承 话 会 为 读者 展现 其 他 的 配置 方案 。 所以， 在 介绍 
文件 上 传 和 异常 处 理 之 前 ， 我 们 先 花 一 点 时 间 探 讨 一 下 如 何 用 其 他 的 方 
式 来 搭建 DispatcherServlet 和 ContextLoaderListener。 

















7.1 Spring MVC 配 置 的 蔡 代 方案 


在 第 5 半 中 ， 我 们 通过 扩 

展 AbstractAnnotationConfigDispatcherServlet-Initializer 快 
速 搭建 了 Spring MVC 环 境 。 在 这 个 便利 的 基础 类 中 ， 假 设 我 们 需要 基本 
的 DispatcherServlet 和 ContextLoaderListener 环 境 ， 并 日 Spring 
配置 是 使 用 Java 的 ， 而 不 是 XML。 


尽管 对 很 多 Spring 应 用 来 说 ， 这 是 一 种 安全 的 假设 ， 但 是 并 不 一 定 总 能 
满足 我 们 的 要 求 。 除 了 DispatcherServlet 以 外 ， 我 们 可 能 还 需要 额 
外 的 Servlet 和 Filter; 我 们 可 能 还 需要 对 DispatcherSservlet 本 号 做 一 
些 额 外 的 配置 ， 或 者 ， 如 果 我 们 需要 将 应 用 部 署 到 Servlet 3.0 之 前 的 容 
器 中 ， 那 么 还 需要 将 DispatcherServlet 配 置 到 传统 的 web.xml 中 。 


7.1.1 自 定 义 DispatcherServlet 配 置 


虽然 从 程序 清单 7.1 的 外 观 上 不 一 定 能 够 看 得 出 来 ， 但 是 Abstract- 
AnnotationConfigDispatcherServletInitializer 所 完成 的 事情 其 
实 比 看 上 去 要 多 。 在 SpittrWebAppInitializer 中 我 们 所 编写 的 三 个 
方法 仅 仪 是 必须 要 重 载 的 abstract 方 法 。 但 实际 上 还 有 更 多 的 方法 可 
以 进行 重 载 ， 从 而 实现 额外 的 配置 。 


此 类 的 方法 之 一 就 是 customizeRegistration() 。 

在 AbstractAnnotation-ConfigDispatcherServletInitializer 
将 DispatcherServlet 注 册 到 Sservlet 容 器 中 之 后 ， 就 会 调 

用 customizeRegistration()， 并 将 Servlet 注 册 后 得 到 的 
Registration.Dynamic 传 递 进来 。 通 过 重 

载 CustomizeRegistration() 方 法 ， 我 们 可 以 对 DispatcherServ1let 
进行 额外 的 配置 。 


例如 ， 在 本 章 稍 后 的 内 容 中 〈7.2 节 ) ， 我 们 将 会 看 到 如 何在 Spring 
MVC 中 处 理 multipart 请 求 和 文件 上 传 。 如 果 计 划 使 用 Servlet 3.0 对 
multipart 配 置 的 支持 ， 那 么 需要 使 用 DispatcherServlet 的 registration 
来 启用 multipart 请 求 。 我 们 可 以 重 载 customizeRegistration() 方 法 
来 设置 MultipartConfigElement， 如 下 所 示 : 














@Override 
protected void customizeRegistration(Dynamic registration) { 


registration.setMultipartConfig( 
new MultipartConfigElement("/tmp/spittr/uploads")); 





借助 customizeRegistration() 方 法 中 的 
ServletRegistration.Dynamic， 我 们 能 够 完成 多 项 任务 ， 包 括 通过 
调用 setLoadonstartup() 设 置 1oad-on-startup 优 先 级 ， 通 过 
setInitParameter() 设 置 初 始 化 参数 ， 通 过 调 

用 setMultipartConfig() 配 置 Servlet 3.0 对 multipart 的 支持 。 在 前 面 的 
样 例 中 ， 我 们 设置 了 对 mnultipart 的 文 持 ， 将 上 传 文件 的 临时 存储 目录 设 
置 在 “/tmp/spittr/uploads” 中 。 


7.1.2 ”添加 其 他 的 Servlet 和 Filter 


按照 AbstractAnnotationConfigDispatcherServletInitializer 
的 定义 ， 它 会 创建 DispatcherServlet 和 ContextLoaderListener。 
但 是 ， 如 果 你 想 注册 其 他 的 Servlet、Filter 或 Listener 的 话 ， 那 该 怎么 办 
呢 ? 


基于 Java 的 初始 化 器 〈initializer) 的 一 个 好 处 就 在 于 我 们 可 以 定义 任意 
数量 的 初始 化 器 类 。 因 此 ， 如 有 果 我 们 想 往 Web 容 器 中 注册 其 他 组 件 的 
话 ， 只 需 创 建 一 个 新 的 初始 化 右 束 可 以 了 。 最 简 蛙 的 方式 就 是 实现 
Spring 的 NebApp1licationInitializer 接 口 。 


例如 ， 如 下 的 程序 清单 展现 了 如 何 创建 WebApplicationInitializer 
实现 并 注册 一 个 Servlet。 


程序 清单 7.1 通过 实现 WebApplicationInitializer 来 注册 Servlet 


Package com.myapp.cr 
import javax.servlet.ServletContext; 





javax.servlet.Servle 
istration.Dynamic; 





rt eR 1 
ork .web .WebApplicationInitializer; 





class MyServletInitializer implements WebApplicationIinitializer { 





EE OP 


public void onstartup{(ServletContext servletContext) 


throws ServletException { i 
: 注册 Servlet 
Dynamic myServlet = 
servletContext.addServlet ("myServlet", MyServlet.class); 
myServlet .addMapping{"/custom/**"); 映射 Servlet 


} 


程序 清单 7.1 是 相当 基础 的 Servlet 注 册 初 始 化 器 类 。 它 注册 了 一 个 Servlet 
并 将 其 映射 到 一 个 路 径 上 。 我 们 也 可 以 通过 这 种 方式 来 手动 注册 
DispatcherServlet。 “但 这 并 没有 必要 ， 
人 


用 太 多 代码 就 将 这 项 任务 完成 得 很 漂亮。 


类 似 地 ， 我 们 还 可 以 创建 新 的 WebApplicationInitializer 实 现 来 注 
册 Listener 和 Filter。 例 如 ， 如 下 的 程序 清单 展现 了 如 何 注册 Filter。 


程序 清单 7.2 注册 Filter 的 WebApplicationInitializer 








-Up (ServletContext servletContext) 
rvletException { 
et.FilterRegistration.Dynamic filter = 注册 Filter 
rletContext .addFilter{"myFilter", MyFilter.class); 





filter.addMappingForUrlPatterns{null, false, "/custom/*"); 


添加 Filter 的 上 映 
射 路 径 


如 果 要 将 应 用 部 署 到 支持 Servlet 3.0 的 容器 中 ， 那 

么 WebApplicationInitializer 提 供 了 一 种 通用 的 方式 ， 实 现在 Java 
中 注册 Servlet、Filter 和 Listener。 不 过 ， 如 果 你 只 是 注册 Filter， 并 且 该 
Filter 只 会 映射 到 DispatcherServlet 上 的 话 ， 那 么 

在 AbstractAnnotationConfigDispatcherServletInitializer 中 


还 有 一 种 快捷 方式 。 
为 了 注册 Filter 并 将 其 映射 到 DispatcherSservlet， 所 需要 做 的 仅仅 是 





重 载 AbstractAnnotationConfigDispatcherServletInitializer 
的 getServlet-Filters() 方 法 。 例 如 ， 在 如 下 的 代码 中 ， 重 载 了 
AbstractAnnotationConfig-DispatcherServletInitializer 的 
getServletFilters() 方 法 以 注册 Filter: 


@Override 
protected Filter[] getServletFilters() { 


return new Filter[] { new MyFilter() }; 
} 





我 们 可 以 看 到 ， 这 个 方法 返回 的 是 一 个 javax.servlet.Filter 的 数 
组 。 在 这 里 它 只 返回 了 一 个 Filter， 但 它 实 际 上 可 以 返回 任意 数量 的 
Filter。 在 这 里 没有 必要 声明 它 的 映射 路 径 ，getSservletFilters() 方 
法 返回 的 所 有 Filter 都 会 映射 到 DispatcherServlet 上 。 


如 有 果 要 将 应 用 部 团 到 Servlet 3.0 容 器 中 ， 那 么 Spring 提供 了 多 种 方式 来 注 
册 Servlet (包括 DispatcherServlet) 、Filter 和 Listener， 而 不 必 创 建 
web.xml 文 件 。 但 是 ， 如 果 你 不 想 采 取 以 上 所 述 方案 的 话 ， 也 是 可 以 
的 。 假 设 你 需要 将 应 用 部 署 到 不 文 持 Servlet 3.0 的 容器 中 《或 者 你 只 是 
希望 使 用 web.xml 文 件 ) ， 那 么 我 们 完全 可 以 按照 传统 的 方式 ， 通 过 
web.xml 配 置 Spring MVC。 让 我 们 看 一 下 该 怎么 做 。 





7.1.3 ”在 web.xml 中 声明 DispatcherServjlet 


在 典型 的 Spring MVC 应 用 中 ， 我 们 会 需要 DispatcherServlet 和 
Context-Loader 

Listener。 AbstractAnnotationConfigDispatcherServletInitia 
会 自动 注册 它们 ， 但 是 如 果 需 要 在 web.xml 中 注册 的 话 ， 那 就 需要 我 们 
自己 来 完成 这 项 任务 了 。 


如 下 是 一 个 基本 的 web.xml 文 件 ， 它 按照 传统 的 方式 搭建 了 


DispatcherServlet 和 ContextLoaderListener。 





程序 清单 7.3 ”在 web.xml 中 搭建 Spring MVC 


<?xml version="1.0" encoding="UTF-8"?> 








<web-app version="2.5" 
xmlns="http://java.sun.com/xml /ns/javaee" 
i/XMLSchema-~instance" 


xsi:schemaLoce sun.com/xml /ns/jJavaee 


http://java.sun.com/xml/ns/javaee/web-app_2._5.xsd"> 
设 署 根 上 下 
<context-param> 设置 根 上 了 
i Wee oy- By 
<param-name>contextConfigLocation</param-name> 文 配置 文件 
1 jr 了 / : ) 27 了 也 
<param-value>/WEB-INF/spring/root-context .xml</param-value> 位 置 


</context-param> 


.context .ContextLoaderListener 





</listener-class> 


注册 ContextLoader- 
Listener 


注册 Dispatcher- 





Servlet 
<servlet-mapping> 
<servlet-name>appServlet</servlet-name> 将 DispatcherServlet 


<url-pattern>/</url-pattern> 映射 到 “/” 
</servlet-mapping> 


</web-app> 





就 像 我 在 第 5 章 曾 经 介绍 过 的 ，ContextLoaderListener 和 和 
DispatcherServlet 各 目 都 会 加 载 一 个 Spring 应 用 上 下 文 。 上 下 文 参 
数 contextConfigLocation 指 定 了 一 个 XML 文件 的 地 址 ， 这 个 文件 定 
义 了 根 应 用 上 下 文 ， 它 会 被 ContextLoaderListener 加 载 。 如 程序 清 
单 7.3 所 示 ， 根 上 下 文 会 从 “/WEB-INF/spring/root-context.xml” 中 加 载 
bean 定 义 。 


DispatcherServlet 会 根据 Servlet 的 名 字 找 到 一 个 文件 ， 并 基于 该 文件 
加 载 应 用 上 下 文 。 在 程序 清单 7.3 中 ，Servlet 的 名 字 是 appServlet， 

此 DispatcherServlet 会 从 “/WEB-INF/appServlet-context.xml” 文 件 中 

加 载 其 应 用 上 下 文 。 


如 果 你 希望 指定 DispatcherServlet 配 置 文件 的 位 置 的 话 ， 那 么 可 以 
在 Servlet 上 指定 一 个 contextConfigLocation 初 始 化 参数 。 例 如 ， 如 
下 的 配置 中 ，DispatcherServlet 会 从 “WEB- 
INF/spring/appServlet/servlet-context.xm]”* 加 载 它 的 bean: 


<servlet> 
<servlet-name>appServlet</servlet-name> 


<servlet-class> 
org.springframework.web.servlet.DispatcherServlet 

</servlet-class> 

<init-param> 
<param-name>contextConfigLocation</param-name> 
<param-value> 

/WEB-INF/spring/appServlet/servlet-context.xml 

</param-value> 

</init-param> 

<load-on-startup>1</load-on-startup> 

</servlet> 





当然 ， 上 面 阐述 的 都 是 如 何 让 DispatcherServlet 和 和 
ContextLoaderListener 从 XML 中 加 载 各 自 的 应 用 上 上 下文。 但 是 ， 在 
本 书 中 的 大 部 分 内 容 中 ， 我 们 都 更 倾 癌 于 使 用 Java 配 置 而 不 是 XML 配 
置 。 因 此 ， 我 们 需要 让 Spring MVC 在 启动 的 时 候 ， 从 带 

有 Q@Configuration 注 解 的 类 上 加 载 配置 。 








要 在 Spring MVC 中 使 用 基于 Java 的 配置 ， 我 们 需要 告诉 
DispatcherServlet 和 ContextLoaderListener 使 

用 AnnotationConfigWebApplicationContext， 这 是 一 

个 WebApplicationContext 的 实现 类 ， 它 会 加 载 Java 配 置 类 ， 而 不 是 
使 用 XML。 要 实现 这 种 配置 ， 我 们 可 以 设置 contextClass 上下文 参数 以 
及 DispatcherServlet 的 初始 化 参数 。 如 下 的 程序 清单 展现 了 一 个 新 
的 web.xml， 在 这 个 文件 中 ， 它 所 搭建 的 Spring MVC 使 用 基于 Java 的 
Spring 配置 : 





程序 清单 7.4 设置 web.xml 使 用 基于 Java 的 配置 


<?xml] Version="1.0" encoding="UTF-8"?> 

<web-app version="2.5" 
xmlns="http://java.sun.com/xml /ns/javaee" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xsi:schemaLocation="http;://java.sun.com/xml/ns/javaee 


http://java.sun.com/xml /ns/javaee/web-app_2_5.xsd"> 


| 使 用 Java 

<context-param> 

<param-name>contextClass</param-name> < | 配置 

<param-value> 

org.springframework.web.context.support. 
AnnotationConfigWebApplicationContext 

</param-value> 

</context-param> 


<context-param> 
<param-name>contextConfigLocation</param-name> 
<param-value>com.habuma.spitter.config.RootConfig</param-value> 村 
</context -param> 


指定 根 配置 类 


<listener> 
<listener-class> 
org.springframework.web.context.ContextLoaderListener 
</listener-class> 
</listener> 
<servlet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework .web.servlet.DispatcherServlet 
</servlet-class> 使 用 Java 
<init-param> 
<param-name>contextClass</param-name> 二 配置 
<param-value> 
org.springframework .web.context .support. 
AnnotationConfigWebApplicationContext 
</param-value> 
</init-param> 
<init-param> 


<param-name>contextConfigLocation</param-name> 二 指定 DispatcherServl 
<param-value> 配置 类 Ee 
com.habuma.spitter.config.WebConfigConfig 


</param-value> 
</init-param> 
<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet-mapping> 
<servlet-name>appServlet</servlet-name> 
<url-pattern>/</url-pattern> 
</servlet-mapping> 


</web-app> 


现在 我 们 已 经 看 到 了 如 何以 多 种 不 同 的 方式 来 搭建 Spring MVC,， 
下 来 我 们 会 看 一 下 如 何 使 用 Spring MVC 来 处 理 文件 上 传 。 


那么 接 


7.2 处理 multipart 形 式 的 数据 


在 Web 应 用 中 ， 人 允许 用 户 上 传 内 容 是 很 常见 的 需求 。 在 Facebook 和 Flickr 
这 样 的 网 站 中 ， 用 户 通常 会 上 传 照片 和 视频 ， 并 与 家 人 和 朋友 分 享 。 还 
有 一 些 服 务 允 许 用 户 上 传 照 片 ， 然 后 按照 传统 方式 将 其 打印 在 纸 上 ， 或 
者 用 在 T 恤 衫 和 咖啡 杯 上 。 


Spittr 应 用 在 两 个 地 方 需要 文件 上 传 。 当 新 用 户 注册 应 用 的 时 候 ， 我 们 
希望 他 们 能 够 上 传 一 张 图 片 ， 从 而 与 他 们 的 个 人 信息 相关 联 。 当 用 户 提 
交 新 的 Spittle 时 ， 除 了 文本 消息 以 外 ， 他 们 可 能 还 会 上 传 一 张 照 亡 。 


一 般 表单 提交 所 形成 的 请 求 结 果 是 很 简单 的 ， 就 是 以 “8&”* 符 分 割 的 多 个 
name-value 对 。 例 如 ， 当 在 Spittr 应 用 中 提交 注册 表单 时 ， 请 求 会 如 下 所 
外: 








firstName=Charles&lastName=Xavier&email=professorx%46xmen .org 


&username=professorx&password=letmein81 





尽管 这 种 编码 形式 很 简单 ， 并 且 对 于 典型 的 基于 文本 的 表单 提交 也 足够 
满足 要 求 ， 但 是 对 于 传送 二 进 制 数据 ， 如 上 传 图 片 ， 束 显得 力不从心 

了 。 与 之 不 同 的 是 ，mnultipart 格 式 的 数据 会 将 一 个 表单 拆 分 为 多 个 部 分 
(part) ， 每 个 部 分 对 应 一 个 输入 域 。 在 一 般 的 表单 输入 域 中 ， 它 所 对 
应 的 部 分 中 会 放置 文本 型 数据 ， 但 是 如 果 上 传 文件 的 话 ， 它 所 对 应 的 部 
分 可 以 是 二 进 制 ， 下 面 展 现 了 multipart 的 请 求 体 : 














------ WebKitFormBoundaryqgkaBn8IHJCuNmiW 
Content-Disposition: form-data; name="firstName" 


Charles 
------ WebKitFormBoundaryqgkaBn8IHJCuNmiW 
Content-Disposition: form-data; name="lastName" 


Xavier 
------ WebKitFormBoundaryqgkaBn8IHJCuNmiW 
Content-Disposition: form-data; name="email" 


charles@xmen .com 
------ WebKitFormBoundaryqgkaBn8IHJCuNmiW 
Content-Disposition: form-data; name="Uusername" 


professorx 
------ WebKitFormBoundaryqgkaBn8IHJCuNmiW 
Content-Disposition: form-data; name="password" 


letmeine1 

------ WebKitFormBoundaryqgkaBn8IHJCuNmiW 

Content-Disposition: form-data; name="profilePicture"; filename="me.jpg" 
Content-Type: image/jpeg 


[[ Binary image data goes here |]] 
------ WebKitFormBoundaryqgkaBn8IHJCuNmiW-- 





在 这 个 multipart 的 请 求 中 ， 我 们 可 以 看 到 profilePicture 部 分 与 其 他 
部 分 明显 不 同 。 除 了 其 他 内 容 以 外 ， 它 还 有 自己 的 Content -Type 头 ， 
表明 它 是 一 个 JPEG 图 片 。 尽 管 不 一 定 那么 明显 ， 但 profilePicture 部 
分 的 请 求 体 是 二 进 制 数据 ， 而 不 是 简单 的 文本 。 


尽管 multipart 请 求 看 起 来 很 复杂 ， 但 在 Spring MVC 中 处 理 它们 却 很 容 
易 。 在 编写 控制 器 方法 处 理 文 件 上 传 之 前 ， 我 们 必须 要 配置 一 个 
multipart 解 析 器 ， 通 过 它 来 告诉 DispatcherServlet 该 如 何 读 取 
multipart 请 求 。 


7.2.1 配置 multipart 解 析 器 


DispatcherServlet 并 没有 实现 任何 解析 multipart 请 求 数据 的 功能 。 它 
将 该 任务 委托 给 了 Spring 中 MultipartResolver 策 略 接口 的 实现 ， 通 过 
这 个 实现 类 来 解析 multipart 请 求 中 的 内 容 。 从 Spring 3.1 开 始 ，Spring 内 
置 了 两 个 MultipartResolver 的 实现 供 我 们 选择 : 








。 CommonsMultipartResolver: 使 用 Jakarta Commons FileUpload 解 
析 multipart 请 求 ; 

。StandardServletMultipartResolver: 依赖 于 Servlet 3.0 对 
multipart 请 求 的 文 持 ( 始 于 Spring 3.1) 。 


一 般 来 讲 ， 在 这 两 者 之 间 ，StandardServletMultipartResolver 可 
能 会 是 优选 的 方案 。 它 使 用 Servlet 所 提供 的 功能 文 持 ， 并 不 需要 依赖 任 
何其 他 的 项 目 。 如 果 我 们 需要 将 应 用 部 署 到 Servlet 3.0 之 前 的 容器 中 ， 
或 者 还 没有 使 用 Spring 3.1 或 更 高 版 本 ， 那 么 可 能 就 需要 


CommonsMultipartResolver J 。 


使 用 Servlet 3.0 解 析 multipart 请 求 


兼容 Servlet 3.0 的 StandardServletMultipartResolver 没 有 构造 器 参 
数 ， 也 没有 要 设置 的 属性 。 这 样 ， 在 Spring 应 用 上 下 文中 ， 将 其 声明 为 
bean 就 会 非常 简单 ， 如 下 所 示 : 


@Bean 
public MultipartResolver multipartResolver() throws IOException { 


return new StandardServletMultipartResolver(); 


} 





既然 这 个 @Bean 方 法 如 此 简单 ， 你 可 能 就 会 怀疑 我 们 到 底 该 如 何 限 

制 SstandardServletMultipartResolver 的 工作 方式 呢 。 如 果 我 们 想 
要 限制 用 户 上 传 文件 的 大 小 ， 该 怎么 实现 ? 如 果 我 们 想 要 指定 文件 在 上 
传 时 ， 临 时 写 入 目录 在 什么 位 置 的 话 ， 该 如 何 实现 ?因为 没有 属性 和 构 
造 器 参数 ，StandardSservletMultipartResolver 的 功能 看 起 来 似乎 
有 些 受 限 。 


其 实 并 不 是 这 样 ， 我 们 是 有 办 法 配 

置 standardServletMultipartResolver 的 限制 条 件 的 。 只 不 过 不 是 
在 Spring 中 配置 standardServletMultipartResolver， 而 是 要 在 
Servlet 中 指定 multipart 的 配置 。 人 至 少 ， 我 们 必须 要 指定 在 文件 上 传 的 过 
程 中 ， 所 写 入 的 临时 文件 路 径 。 如 果 不 设 定 这 个 最 基本 配置 的 

话 ，StandardServlet-MultipartResolver 就 无 法 正常 工作 。 具 体 来 
讲 ， 我 们 必须 要 在 web.xml 或 Servlet 初 始 化 类 中 ， 将 multipart 的 具体 细 市 
作为 DispatcherServlet 配 置 的 一 部 分 。 








如 果 我 们 采用 Servlet 初 始 化 类 的 方式 来 配置 DispatcherServlet 的 话 ， 
这 个 初始 化 类 应 该 已 经 实现 了 WebApplicationInitializer， 那 我 们 
可 以 在 Servlet registration 上 调用 setMultipartConfig() 方 法 ， 传 入 一 
个 MultipartConfig-Element 实 例 。 如 下 是 最 基本 的 
DispatcherServlet mnultipart 配 置 ， 它 将 临时 路 径 设 置 

为 “/tmp/spittr/uploads”: 


DispatcherServlet ds = new DispatcherServlet(); 
Dynamic registration = context.addServlet("appServlet", ds); 


registration.addMapping("/"); 
registration.setMultipartConfig( 
new MultipartConfigElement("/tmp/spittr/uploads")); 





如 果 我 们 配置 DispatcherServlet 的 Servlet 初 始 化 类 继承 了 Abstract 
AnnotationConfigDispatcherServletInitializer 

或 AbstractDispatcher-ServletInitializer 的 话 ， 那 么 我 们 不 会 
直接 创建 DispatcherServlet 实 例 并 将 其 注册 到 Servlet 上 下 文中 。 这 样 
的 话 ， 将 不 会 有 对 Dynamic Servlet registration 的 引用 供 我 们 使 用 了 。 但 
是 ， 我 们 可 以 通过 重 载 customizeRegistration() 方 法 〈 它 会 得 到 一 
个 Dynamic 作为 参数 ) 来 配置 multipart 的 具体 细节 : 


@Override 
protected void customizeRegistration(Dynamic registration) { 


registration.setMultipartConfig( 
new MultipartConfigElement("/tmp/spittr/uploads")); 





到 目前 为 止 ， 我 们 所 使 用 是 只 有 一 个 参数 的 MultipartConfigElement 
构造 器 ， 这 个 参数 指定 的 是 文件 系统 中 的 一 个 绝对 目录 ， 上 传 文件 将 会 
临时 写 入 该 目录 中 。 但 是 ， 我 们 还 可 以 通过 其 他 的 构造 器 来 限制 上 传 文 
件 的 大 小 。 除 了 临时 路 径 的 位 置 ， 其 他 的 构造 器 所 能 接受 的 参数 如 下 : 


。 上 传 文件 的 最 大 容量 《以 字 节 为 单位 ) 。 默 认 是 没有 限制 的 。 

。 整个 multipart 请 求 的 最 大 容量 〈 以 字 节 为 单位 ) ， 不 会 关心 有 多 少 
个 part 以 及 每 个 part 的 大 小 。 默 认 是 没有 限制 的 。 

。 在 上 传 的 过 程 中 ， 如 采 文 件 大 小 达到 了 一 个 指定 最 大 容量 《以 字 节 
为 单位 )， 将 会 写 入 到 临时 文件 路 径 中 。 默 认 值 为 0， 也 就 是 所 有 
上 传 的 文件 都 会 写 入 到 磁盘 上 。 


例如 ， 假 设 我 们 想 限制 文件 的 大 小 不 超过 2MB， 整 个 请 求 不 超过 4MB， 
而 且 所 有 的 文件 都 要 写 到 磁盘 中 。 下 面 的 代码 使 
用 MultipartConfigElement 设 置 了 这 些 临 界 值 : 














@Override 
protected void customizeRegistration(Dynamic registration) { 
registration.setMultipartConfig( 


new MultipartConfigElement("/tmp/spittr/uploads", 
2697152，4194364，6)); 





如 果 我 们 使 用 更 为 传统 的 web.xml 来 配置 MultipartConfigElement 的 
话 ， 那 么 可 以 使 用 <servlet> 中 的 <multipart-config> 元 素 ， 如 下 所 


不 : 


<servlet> 
<servlet-name>appServlet</servlet-name> 
<servlet-class> 
org.springframework.web.servlet.DispatcherServlet 
</servlet-class> 
<load-on-startup>1</1load-on-startup> 


<multipart-config> 
<location>/tmp/spittr/uploads</location> 
<max-file-size>28697152</max-file-size> 
<max-request-size>4194364</max-request-size> 
</multipart-config> 
</servlet> 





<multipart-config> 的 默认 值 与 MultipartConfigElement 相 同 。 
与 MultipartConfigElement 一 样 ， 必 须要 配置 的 是 <location>。 


配置 Jakarta Commons FileUpload multipart 解 析 器 


通常 来 讲 ，StandardServletMultipartResolver 会 是 最 佳 的 选择 ， 
但 是 如 果 我 们 需要 将 应 用 部 署 到 非 Servlet 3.0 的 容器 中 ， 那 么 就 得 需要 
蔡 代 的 方案 。 如 果 喜 欢 的 话 ， 我 们 可 以 编写 上 自己 的 
MultipartResolver 实 现 。 不 过 ， 除 非 想 要 在 处 理 multipart 请 求 的 时 候 
执行 特定 的 逻辑 ， 否 则 的 话 ， 没 有 必要 这 样 做 。Spring 内 置 了 
CommonsMultipartResolver， 可 以 作 

为 StandardServletMultipartResolver 的 蔡 代 方案 。 


园 久生 


将 CommonsMultipartResolver 声 明 为 Spring bean 的 最 简单 方式 如 下 : 


@Bean 
public MultipartResolver multipartResolver() { 


return new CommonsMultipartResolver(); 


} 





与 standardServletMultipartResolver 有 所 不 

同 ，CommonsMultipart-Resolver 不 会 强制 要 求 设置 临时 文件 路 径 。 
默认 情况 下 ， 这 个 路 径 就 是 Servlet 容 器 的 临时 目录 。 不 过 ， 通 过 设 
置 uploadTempDir 属 性 ， 我 们 可 以 将 其 指定 为 一 个 不 同 的 位 置 : 


@Bean 


public MultipartResolver multipartResolver() throws IOException { 
CommonsMultipartResolver multipartResolver = 
new CommonsMultipartResolver(); 
multipartResolver.setUploadTempDir( 
new FileSystemResource("/tmp/spittr/uploads")); 
return multipartResolver; 


} 





实际 上 ， 我 们 可 以 按照 相同 的 方式 指定 其 他 的 multipart 上 传 细节 ， 也 束 
是 设置 CommonsMultipartResolver 的 属性 。 例 如 ， 如 下 的 配置 就 等 价 
于 我 们 在 前 文通 过 MultipartConfigElement 所 配置 的 
StandardServletMultipartResolver: 


@Bean 
public MultipartResolver multipartResolver() throws IOException { 
CommonsMultipartResolver multipartResolver = 
new CommonsMultipartResolver(); 
multipartResolver.setUploadTempDir( 


new FileSystemResource("/tmp/spittr/uploads")); 
multipartResolver.setMaxUploadSize(2897152); 
multipartResolver .setMaxInMemorySize(6); 
return multipartResolver; 





在 这 里 ， 我 们 将 最 大 的 文件 容量 设置 为 2MB， 最 大 的 内 存 大 小 设置 为 0 
字 节 。 这 两 个 属性 直接 对 应 于 MultipartConfigElement 的 第 二 个 和 第 
四 个 构造 嚣 参数， 表明 不 能 上 传 超过 2MB 的 文件 ， 并 且 不 管 文件 的 大 小 
如 何 ， 所 有 的 文件 都 会 写 到 磁盘 中 。 但 是 与 MultipartConfigElement 
有 所 不 同 ， 我 们 无 法 设 定 multipart 请 求 整体 的 最 大 容量 。 





7.2.2 ”处 理 multipart 请 求 


现在 已 经 在 Spring 中 〈 或 Servlet 容 器 中 ) 配置 好 了 对 mutipart 请 求 的 处 
理 ， 那 么 接 下 来 我 们 就 可 以 编写 控制 器 方法 来 接收 上 传 的 文件 。 要 实现 
这 一 点 ， 最 常见 的 方式 就 是 在 某 个 控制 器 方法 参数 上 添 

加 @RequestPart 注 解 。 


假设 我 们 允许 用 户 在 注册 Spittr 应 用 的 时 候 上 传 一 张 图 片 ， 那 么 我 们 需 
要 修改 表单 ， 以 允许 用 户 选 择 要 上 传 的 图 片 ， 同 时 还 需要 修 

改 SpitterController 中 的 processRegistration() 方 法 来 接收 上 传 
的 图 片 。 如 下 的 代码 片段 来 源 于 Thymeleaf 广 册 表 单 视 图 














GregistrationForm.html) ， 痢 重 强调 了 表单 所 需 的 修改 : 


<form method="POST" th:object="${spitter}" 
enctype="multipart/form-data"> 


<label>Profile Picture</label>: 
<input type="file" 


name="profilepicture" 
accept="image/jpeg,image/png, image/gif" /><br/> 





<form> 标 签 现在 将 enctype 属 性 设置 为 nultipart/form-data， 这 会 
告诉 浏览 器 以 multipart 数 据 的 形式 提交 表单 ， 而 不 是 以 表单 数据 的 形式 
进行 提交 。 在 multipart 中 ， 每 个 输入 域 都 会 对 应 一 个 part。 


除了 注册 表单 中 己 有 的 输入 域 ， 我 们 还 添加 了 一 个 新 的 <input> 域 ， 

其 type 为 file。 这 能 够 让 用 户 选 择 要 上 传 的 图 片 文件 。accept 属 性 用 来 
将 文件 类 型 限制 为 JPEG、PNG 以 及 GIF 图 片 。 根 据 其 name 属 性 ， 图 片 数 
据 将 会 发 送 到 multipart 请 求 中 的 profilePicture part 之 中 。 





现在 ， 我 们 需要 修改 processRegistration() 方 法 ， 使 其 能 够 接受 上 
传 的 图 片 。 其 中 一 种 方式 是 添加 byte 数 组 参数 ， 并 为 其 添 
加 @RequestPart 注 解 。 如 下 为 示例 : 


@RequestMapping(value="/register", method=POST) 

public String processRegistration( 
@Requestpart("profilepicture") byte[] profilePicture， 
@Valid Spitter spitter, 


Errors errors) { 








当 注 册 表 单 提交 的 时 候 ，profilePicture 属 性 将 会 给 定 一 个 byte 数 
组 ， 这 个 数组 中 包含 了 请 求 中 对 应 part 的 数据 (通过 @RequestPart 指 
EE ) 。 如 果 用 户 提 交 表 单 的 时 候 没 有 选择 文件 ， 那 么 这 个 数组 会 是 空 
(而 不 是 nul11〉。 获 取 到 图 片 数 据 后 ，processRegistration() 方 法 
剩 下 的 任务 就 是 将 文件 保存 到 某 个 位 置 。 


我 们 将 会 稍 后 讨论 如 何 保存 文件 。 但 首先 ， 想 一 下 ， 对 于 提交 的 图 片 数 
据 我 们 都 了 解 哪些 信息 呢 。 或 者 ， 更 为 重要 的 是 ， 我 们 还 不 知道 些 什 么 
呢 ? 尽管 我 们 已经 得 到 了 byte 数 组 形式 的 图 片 数据 ， 并 且 根 据 它 能 够 得 
到 图 片 的 大 小 ， 但 是 对 于 其 他 内 容 我 们 束 一 无 所 知 了 。 我 们 不 知道 文件 
的 类 型 是 什么 ， 甚 至 不 知道 原始 的 文件 名 是 什么 。 你 需要 判断 如 何 

将 byte 数 组 转换 为 可 存储 的 文件 。 


接受 MultipartFile 


使 用 上 传 文件 的 原始 byte 比 较 人 简单 但 是 功能 有 限 。 因 此 ，Spring 还 提供 
了 MultipartFile 接 口 ， 它 为 处 理 multipart 数 据 提 供 了 内 容 更 为 丰富 的 
对 象 。 如 下 的 程序 清单 展现 了 MultipartFile 接 口 的 概况 。 


2 清单 7.5 Spring 所 提供 的 MultipartFile 接 口 ， 用 来 处 理 上 传 的 文 


package org.springframework.web.multipart; 
import java.io.File; 

import java.io.IOException; 

import java.io.InputStream; 


public interface MultipartFile { 
String getName(); 


String getOriginalFilename(); 

String getContentType(); 

boolean isEmpty(); 

long getSizel(); 

byte[] getBytes() throws IOException; 
InputStream getInputStream() throws IOException; 
void transferTo(File dest) throws IOException; 





我 们 可 以 看 到 ，MultipartFile 提 供 了 获取 上 传 文 件 byte 的 方式 ， 但 是 
它 所 提供 的 功能 并 不 仅 限 于 此 ， 还 能 获得 原始 的 文件 名 、 大 小 以 及 内 容 
类 型 。 它 还 提供 了 一 个 InputSstream， 用 来 将 文件 数据 以 流 的 方式 进行 
读 取 。 


除 此 之 外 ，Mu1ltipartFile 还 提供 了 一 个 便利 的 transferTo() 方 法 ， 
它 能 够 帮助 我 们 将 上 传 的 文件 写 入 到 文件 系统 中 。 作 为 样 例 ， 我 们 可 以 
在 process-Registration() 方 法 中 添加 如 下 的 几 行 代码 ， 从 而 将 上 传 
的 图 片 文 件 写 入 到 文件 系统 中 : 





profilePicture.transferTo( 





new File("/data/spittr/" + profilePicture.getoriginalFilename())); 


将 文件 保存 到 本 地 文件 系统 中 是 非常 简单 的 ， 但 是 这 需要 我 们 对 这 些 文 
件 进行 管理 。 我 们 需要 确保 有 足够 的 空间 ， 确 保 当 出 现 硬件 故障 时 ， 文 
人 还 需要 在 集群 的 多 个 服务 器 之 间 处 理 这 些 图 片 文件 的 同 
2 





将 文件 保存 到 Amazon S3 中 


另外 一 种 方案 就 是 让 别人 来 负责 处 理 这 些 事情 。 多 加 几 行 代码 ， 我 们 就 
能 将 图 片 保存 到 云端 。 例 如 ， 如 下 的 程序 清单 所 展现 的 saveImage() 方 
法 能 够 将 上 传 的 文件 保存 到 Amazon S3 中 ， 我 们 
在 processRegistration() 中 可 以 调用 该 方法 。 





程序 清单 7.6 ”将 MultipartFile 保 存 到 Amazon S3 中 


private void saveImage (MultipartFile image 
throws ImageUploadException { 
构建 S3 
服务 A 创建 S3 buckel 
和 object 
设置 图 片 
数据 
设置 权限 





保存 图 片 





oadExceptionl"'Unable to save image'", e); 


saveImage() 方 法 所 做 的 第 一 件 事 就 是 构建 Amazon Web 

Service (AWS) 凭证 。 为 了 完成 这 一 点 ， 你 需要 有 一 个 S3 Access Key 
和 S3 Secret Access Key。 当 注册 S3 服 务 的 时 候 ，Amazon 会 将 其 提供 给 
你 。 它 们 会 通过 值 注入 的 方式 提供 给 Spitter-Controller。 


AWS 和 凭证 准备 好 后 ，saveImage() 方 法 创建 了 一 个 JetS3t 的 
RestSs3Service 实 例 ， 可 以 通过 它 来 操作 S3 文 件 系统 。 它 获取 
spitterImages bucket 的 引用 并 创建 用 来 包含 图 片 的 S30bJject 对 象 ， 
接 下 来 将 图 片 数据 填充 到 S30bject。 


在 调用 putobject() 方 法 将 图 片 数 据 写 到 S3 之 前 ，saveImage( ) 方 法 设 
置 了 S30bject 的 权限 ， 从 而 允许 所 有 的 用 户 查 看 它 。 这 是 很 重要 的 
一 一 如 果 没 有 它 的 话 ， 这 些 图 片 对 我 们 应 用 程序 的 用 户 就 是 不 可 见 的 。 
最 后 ， 如 果 出 现任 何 问 题 的 话 ， 将 会 抛 出 ImageUploadException 腊 
常 。 


以 Part 的 形式 接受 上 传 的 文件 


如 果 你 需要 将 应 用 部 署 到 Servlet 3.0 的 容器 中 ， 那 么 会 

有 Mu1ltipartFile 的 一 个 蔡 代 方案 。Spring MVC 也 能 接受 
javax.servlet.http.Part 作 为 控制 器 方法 的 参数 。 如 果 使 用 Part 来 
替换 MultipartFile 的 话 ， 那 么 processRegistration() 的 方法 签名 
将 会 变 成 如 下 的 形式 : 











@RequestMapping(value="/register", method=POST) 
public String processRegistration( 
@Requestpart("profilepicture") Part profilePicture， 


@Valid Spitter spitter, 
Errors errors) { 





就 主体 来 言 (不 开玩笑 地 说 )，Part 接 口 与 MultipartFile 并 没有 太 大 
的 差别 。 在 如 下 的 程序 清单 中 ， 我 们 可 以 看 到 Part 接 口 的 有 一 些 方法 其 
实 是 与 MultipartFile 相 对 应 的 。 





程序 清单 7.7 Part 接口 : Spring MultipartFile 的 替代 方案 





package javax.servlet.http; 
import java.io.*; 
import java.util.*; 


public interface Part { 
public Inputstream getInputStream() throws IOException; 
public String getContentType(); 
public String getName(); 


public String getSubmittedFileName(); 

public long getSize(); 

public void write(String fileName) throws IOException; 
public void delete() throws IOException; 

public String getHeader(String name); 

public Collection<String> getHeaders(String name ) ; 
public Collection<String> getHeaderNames(); 








在 很 多 情况 下 ，Part 方 法 的 名 称 与 MultipartFile 方 法 的 名 称 是 完全 相 
同 的 。 有 一 些 比较 类 似 ， 但 是 稍 有 差异 ， 比 如 
getSubmittedFileName() 对 应 于 getOoriginalFilename()。 类 似 
地 ，write() 对 应 于 transferTo()， 借 助 该 方法 我 们 能 够 将 上 传 的 文 
件 写 入 文件 系统 中 : 


profilepicture.write("/data/spittr/" + 


profilepicture.getOriginalFilename()); 











值得 一 提 的 是 ， 如 果 在 编写 控制 器 方法 的 时 候 ， 通 过 Part 参 数 的 形式 接 
受 文件 上 传 ， 那 么 就 没有 必要 配置 MultipartResolver 了 。 只 有 使 
用 MultipartFile 的 时 候 ， 我 们 才 需 要 MultipartResolver。 


7.3 ”处 理 异 党 


到 现在 为 止 ， 在 Spittr 应 用 中 ， 我 们 假设 所 有 的 功能 都 正音 运行 。 但 古 
如 末 茶 个 地 方 出 错 的 话 ， 该 怎么 办 呢 ? 妆 人 处理 请 求 的 时 候 ， 抛 出 异常 该 
怎么 处 理 昵 ? 如 果 发 生 了 这 样 的 情况 ， 该 给 客户 端 什 么 啊 应 呢 ? 


不 管 发 生 什 么 事情 ， 不 管 是 好 的 还 是 坏 的 ，Servlet 请 求 的 输出 都 是 一 个 
Servlet 啊 应 。 如 果 在 请 求 处 理 的 时 候 ， 出 现 了 有 异常 ， 那 它 的 输出 依然 会 
是 Servlet 啊 应 。 异 党 必须 要 以 某 种 方式 转换 为 啊 应 。 


Spring 提 供 了 多 种 方式 将 异常 转换 为 啊 应 : 


。 特定 的 Spring 异常 将 会 自动 映射 为 指定 的 HITP 状 态 码 ; 

。 异常 上 可 以 添加 @ResponseStatus 注 解 ， 从 而 将 其 映射 为 某 一 个 
HTTP 状 态 码 ; 

。 在 方法 上 可 以 添加 @ExceptionHandler 注 解 ， 使 其 用 来 处 理 异 
常 。 











处 理 腊 第 的 最 简单 方式 就 是 将 其 映射 到 HTTP 状 态 码 上 ， 进 而 放 到 啊 应 
之 中 。 接 下 来 ， 我 们 看 一 下 如 何 将 异 第 映 射 为 条 一 个 HTTP 状 态 码 。 


7.3.1 将 异常 鼎 冉 为 HTTP 状 态 码 


在 默认 情况 下 ，Spring 会 将 目 身 的 一 些 异 常 目 动 转换 为 合适 的 状态 码 。 
表 7.1 列 出 了 这 些 映射 关系 。 


表 7.1 Spring 的 一 会 默认 映射 为 HTTP 状 态 码 











ConversionNotSupportedException 500 - Internal Server Error 


HttpMediaTypeNotAcceptableException 406 - Not Acceptable 





表 7.1 中 的 异常 一 般 会 由 Spring 自身 抛 出 ， 作 为 DispatcherServlet 处 
理 过 程 中 或 执行 校 验 时 出 现 问题 的 结果 。 例 如 ， 如 果 
DispatcherServlet 无 法 找到 适合 处 理 请 求 的 控制 嚣 方法， 那么 将 会 
抛 出 NoSuchRequestHandlingMethodException 异 常 ， 最 终 的 结果 就 
是 产生 404 状 态 人 码 的 啊 应 (Not Found) 。 


尽管 这 些 内 置 的 映射 是 很 有 用 的 ， 但 是 对 于 应 用 所 抛 出 的 异常 它们 就 无 
能 为 力 了 。 垃 好 ，Spring 提 供 了 一 种 机 制 ， 能 够 通过 @ResponseStatus 
注解 将 异常 映射 为 HTTP 状态 码 。 


为 了 阅 述 这 项 功能 ， 请 参考 spittleController 中 如 下 的 请 求 处 理 方 
法 ， 它 可 能 会 产生 HTTP 404 状 态 (但 目前 还 没有 实现 ): 


@RequestMapping(value="/{spittleId}", method=RequestMethod .GET) 





public String spittle( 
@PathVariable("spittleId") long spittleId， 
Model model) { 
Spittle spittle = spittleRepository.findOone(spittleld); 
if (spittle == null) { 
throw new SpittleNotFoundException(); 


model.addAttribute(spittle); 
return "spittle"; 





在 这 里 ， 会 从 SpittleRepository 中 ， 通 过 ID 检 索 Spittle 对 象 。 如 
果 findone( ) 方 法 能 够 返回 spittle 对 象 的 话 ， 那 么 会 将 Spittle 放 到 
模型 中 ， 然 后 名 为 spittle 的 视图 会 负 贡 将 其 演 染 到 啊 应 之 中 。 但 是 如 
果 findone( 1) 方法 返回 nul1 的 话 ， 那 么 将 会 抛 出 
SpittleNotFoundException 异 常 。 现 

在 SpittleNotFoundException 就 是 一 个 简单 的 非 检 查 型 异常 ， 如 下 所 


ES 


package spittr.web; 
public class SpittleNotFoundException extends RuntimeException { 


} 


如 果 调 用 spittle() 方 法 来 处 理 请 求 ， 并 且 给 定 ID 获取 到 的 结果 为 空 ， 
那么 SpittleNotFoundException (默认 ) 将 会 产生 500 状 态 码 
(Internal Server Error) 的 啊 应 。 实 际 上 ， 如 果 出 现任 何 没 有 映射 的 异 
第 ， 咖 应 都 会 带 有 500 状 态 码 ， 但 是 ， 我 们 可 以 通过 映 

射 SpittleNotFoundException 对 这 种 默认 行为 进行 变更 。 








当 抛 出 SpittleNotFoundException 异 常 时 ， 这 是 一 种 请 求 资源 没有 找 
到 的 场景 。 如 果 资 源 没 有 找到 的 话 ，HTTP 状 态 码 404 是 最 为 精确 的 啊 应 
状态 码 。 所 以 ， 我 们 要 使 用 @ResponseStatus 注 解 

将 SpittleNotFoundException 映 射 为 HTTP 状 态 码 404。 


程序 清单 7.8”@ResponseStatus 注 解 : 将 异 和 上 映射 为 特定 的 状态 码 


将 异常 映射 为 
HTTP 状态 404 





在 引入 @ResponseStatus 注 解 之 后 ， 如 果 控 制 器 方法 抛 出 
SpittleNotFound-Exception 寞 常 的 话 ， 啊 应 将 会 具有 404 状 态 人 码 ， 
这 是 因为 Spittle Not Found。 


7.3.2 ”编写 异常 处 理 的 方法 


在 很 多 的 场景 下 ， 将 异常 映射 为 状态 码 是 很 简单 的 方案 ， 并 且 承 功能 3 
说 也 足够 了 了。 但 是 如 果 我 们 想 在 啊 应 中 不 仅 要 包括 状态 码 ， 还 要 包含 所 
产生 的 错误 ， 那 该 怎么 办 呢 ? 此 时 的 话 ， 我 们 就 不 能 将 异常 视 为 HITP 
错误 了 ， 而 是 要 按照 处 理 请 求 的 方式 来 处 理 异 常 了 。 

作为 样 例 ， 假 设 用 户 试图 创建 的 Spittle 与 已 创建 的 Spittle 文 本 完全 
相同 ， 那 么 SpittleRepository 的 save( ) 方 法 将 会 抛 出 
DuplicateSpittle Exception 异 常 。 这 意味 着 SpittleController 
的 saveSpittle() 方 法 可 能 需要 处 理 这 个 异常 。 如 下 面 的 程序 清单 所 
示 ，saveSpittle() 方 法 可 以 直接 处 理 这 个 异常。 


程序 清单 7.9 在 处 理 请 求 的 方法 中 直接 处 理 异 各 


&RequestMapping (method=RequestMethod.POST) 











public String saveSpittlel(lSpittleForm form, Model model) { 










spittieRepository.savel 
new Spittle(null, form.getMessage(), new Datel()， 
form.getLongitude(), form.getbatitude()})); 
return "r sct:/spittles"; 捕获 异常 
} h (DuplicateSpittleException el { 
return "error/duplicate"; 


程序 清单 7.9 中 并 没有 特别 之 处 ， 它 只 是 在 Java 中 人 处理 异常 的 基本 样 例 ， 
除 此 之 外 ， 也 就 没什么 了 。 

它 运 行 起 来 没什么 问题 ， 但 是 这 个 方法 有 些 复杂 。 该 方法 可 以 有 两 个 路 
径 ， 每 个 路 径 会 有 不 同 的 和 输出。 如果 能 让 saveSpittle() 方 法 只 关注 正 





确 的 路 径 ， 而 让 其 他 方法 处 理 异 常 的 话 ， 那 么 它 就 能 简单 一 些 。 
首先 ， 让 我 们 首先 将 saveSpittle() 方 法 中 的 异常 处 理 方法 剥离 掉 : 





@RequestMapping(method=RequestMethod .POST) 
public String saveSpittle(SpittleForm form, Model model) { 
spittleRepository .savel 


new Spittle(null, form.getMessage(), new Date()， 
form.getLongitude(), form.getLatitude())); 
return "redirect:/spittles"; 





可 以 看 到 ，saveSpittle() 方 法 简单 了 许多 。 因 为 它 只 关注 成 功 保 
存 Spittle 的 情况 ， 所 以 只 有 一 个 执行 路 径 ， 很 容易 理解 《和 测试 ) 。 


现在 ， 我 们 为 SpittleController 添 加 一 个 新 的 方法 ， 它 会 处 理 抛 出 
DuplicateSpittleException 的 情况 : 





@ExceptionHandler(DuplicateSpittleException.class) 
public String handleDuplicateSpittle() { 


return "error/duplicate"; 


} 





handleDuplicateSpittle() 方 法 上 添加 了 @ExceptionHandler 注 

解 ， 当 抛 出 DuplicateSspittleException 异 常 的 时 候 ， 将 会 委托 该 方 

法 来 处 理 。 它 返回 的 是 一 个 String， 这 与 处 理 请 求 的 方法 是 一 致 的 ， 

ee 它 能 够 告诉 用 户 他 们 正在 试图 创建 一 条 重 
J 条目 。 


对 于 @ExceptionHandler 注 解 标注 的 方法 来 说 ， 比 较 有 意思 的 一 点 在 
于 它 能 处 理 同一 个 控制 器 中 所 有 处 理 器 方法 所 抛 出 的 异常 。 所 以 ， 尽 管 
我 们 从 saveSpittle() 中 抽取 代码 创建 了 
handleDuplicateSpittle() 方 法 ， 但 是 它 能 够 处 

理 spittleController 中 所 有 方法 所 抛 出 的 
DuplicateSpittleException 寞 常 。 我 们 不 用 在 每 一 个 可 能 抛 出 
DuplicatespittleException 的 方法 中 添加 异常 处 理 代码 ， 这 一 个 方 
法 就 涵盖 了 所 有 的 功能 。 


既然 @ExceptionHandler 注 解 所 标注 的 方法 能 够 处 理 同一 个 控制 器 类 
中 所 有 处 理 器 方法 的 异常 ， 那 么 你 可 能 会 问 有 没有 一 种 方法 能 够 处 理 所 








有 控制 恬 中 处 理 器 方法 所 抛 出 的 异 利 呢 。 从 Spring 3.2 开 始 ， 这 肯定 是 能 
够 实现 的 ， 我 们 只 需 将 其 定义 到 控制 右 通 知 类 中 即 可 。 

什么 是 控制 器 通知 方法 ? 很 高 兴 你 会 问 这 样 的 问题 ， 因 为 这 就 是 我 们 下 
面 要 讲 的 内 容 。 


7.4 为 控制 锅 添 加 通知 


如 采 控 制 器 类 的 特定 切面 能 够 运用 到 整个 应 用 程序 的 所 有 控制 右 中 ， 那 
么 这 将 会 便利 很 多 。 举 例 来 说 ， 如 有 果 要 在 多 个 控制 器 中 处 理 寞 常 ， 那 

Q@ExceptionHandler 注 解 所 标注 的 方法 是 很 有 用 的 。 不 过 ， 如 果 多 个 
控制 器 类 中 都 会 抛 出 某 个 特定 的 异常 ， 那 么 你 可 能 会 发 现 要 在 所 有 的 控 
制 器 方法 中 重复 相同 的 @ExceptionHandler 方 法 。 或者， 为 了 避免 重 
复 ， 我 们 会 创建 一 个 基础 的 控制 器 类 ， 所 有 控制 器 类 要 扩展 这 个 类 ， 从 
而 继承 通用 的 @ExceptionHandler 方 法 。 


Spring 3.2 为 这 类 问题 引入 了 一 个 新 的 解决 方案 : 控制 器 通知 。 控 制 器 通 
知 (controller advice) 是 任意 带 有 @ControllerAdvice 注 解 的 类 ， 这 个 
类 会 包含 一 个 或 多 个 如 下 类 型 的 方法 : 


。OExceptionHandler 注 解 标 注 的 方法 ; 
。@InitBinder 注 解 标注 的 方法 ; 
。 QModelAttribute 注 解 标注 的 方法 。 


在 带 有 @ControllerAdvice 注 解 的 类 中 ， 以 上 所 述 的 这 些 方法 会 运用 
到 整个 应 用 程序 所 有 控制 器 中 带 有 @RequestMapping 注 解 的 方法 上 。 


@ControllerAdvice 注 解 本 里 已 经 使 用 了 @Component， 
此 @ControllerAdvice 注 解 所 标注 的 类 将 会 自动 被 组 件 扫 插 获取 到 ， 
就 像 带 有 @Component 注 解 的 类 一 样 。 


@ControllerAdvice 最 为 实用 的 一 个 场景 就 是 将 所 有 的 
@ExceptionHandler 方 法 收集 到 一 个 类 中 ， 这 样 所 有 控制 器 的 异常 就 
能 在 一 个 地 方 进行 一 致 的 处 理 。 例 如 ， 我 们 想 

将 DuplicateSpittleException 的 处 理 方法 用 到 整个 应 用 程序 的 所 有 
控制 器 上 。 如 下 的 程序 清单 展现 的 AppWideExceptionHandler 就 能 完 
成 这 一 任务 ， 这 是 一 个 带 有 @ControllerAdvice 注 解 的 类 。 


程序 清单 7.10 使 用 @ControllerAdvice， 为 所 有 的 控制 器 处 理 异常 

















Package spitter.web; 
import org.springframework.web.bind.annotation.ControllerAdvice; 


import org.springframework.web.bind.annotation.ExceptionHandler; 


@ControllerAdvice < 定义 控制 

public class AppWideExceptionHandler { 器 类 
&@ExceptionHandler {DuplicateSpittleException.class) 定义 异常 处 理 

i pk NT ee el 让 “有 3 2 日 
public String dupllcateSpittleHandler() { A " 
return "error/duplicate"; 方法 

} 

} 


现在 ， 如 果 任 意 的 控制 器 方法 抛 出 了 Dup1licateSpittleException， 

不 管 这 个 方法 位 于 哪个 控制 器 中 ， 都 会 调用 这 

个 duplicateSpittleHandler() 方 法 来 处 理 异常 。 我 们 可 以 像 编 写 

@RequestMapping 注 解 的 方法 那样 来 编写 @ExceptionHandler 注 解 的 
方法 。 如 程序 清单 7.10 所 示 ， 它 返回 “errorduplicate” 作 为 逻辑 视图 名 ， 

因此 将 会 为 用 户 展 现 一 个 友好 的 出 错 页 面 。 








7.5 ”路 重 定 癌 请 求 传递 数据 


在 5.4.1 小 节 中 ， 在 处 理 完 POST 请 求 后 ， 通 党 来 讲 一 个 最 佳 实践 就 是 执 
行 一 下 重 定 同 。 除 了 其 他 的 一 些 因 系 外 ， 这 样 做 能 够 防止 用 户 点 击 浏览 
融 的 刷新 按钮 或 后 退 箭头 时 ， 客 户 端 重新 执行 危险 的 POST 请 求 。 


在 第 5 章 ， 在 控制 器 方法 返回 的 视图 名 称 中 ， 我 们 借助 

了 “redirect:” 前 级 的 力量 。 当 控制 占 方 法 返回 的 String 值 

以 “redirect:” 开 头 的 话 ， 那 么 这 个 String 不 是 用 来 查找 视图 的 ， 而 是 
用 来 指导 浏览 器 进行 重 定向 的 路 径 。 我 们 可 以 回头 看 一 下 程序 清单 
5.17， 可 以 看 到 processRegistration() 方 法 返回 

的 “redirect:String” 如 下 所 示 : 





























return "redirect:/spitter/" + spitter.getUsername(); 





“redirect:” 前 级 能 够 让 重 定 同 功 能 变 得 非常 简单 。 你 可 能 会 想 spring 
很 难 再 让 重 定向 功能 变 得 更 简单 了 。 但 是 ， 请 稍 等 ，Spring 为 重 定向 
功能 还 提供 了 一 些 其 他 的 辅助 功能 。 


具体 来 讲 ， 正 在 发 起 重 定 癌 功 能 的 方法 该 如 何 发 送 数据 给 重 定 癌 的 目标 
方法 呢 ? 一 般 来 讲 ， 当 一 个 处 理 圳 方法 完成 之 后 ， 该 方法 所 指定 的 模型 
数据 将 会 复制 到 请 求 中 ， 并 作为 请 求 中 的 属性 ， 请 求 会 转 及 《forward ) 
到 视图 上 进行 泻 染 。 因 为 控制 器 方法 和 视图 所 处 理 的 是 同一 个 请 求 ， 所 
以 在 转发 的 过 程 中 ， 请 求 属性 能 够 得 以 保存 。 


但 是 ， 如 图 7.1 所 示 ， 妆 控制 器 的 结果 古 重 定 疝 的 话 ， 原 始 的 请 求 束 结 

束 了 ， 并 且 会 肥 起 一 个 新 的 GET 请 求 。 原 始 请 求 中 所 市 有 的 模型 数据 也 
就 随 独 请 求 一 起 消亡 了 。 在 新 的 请 求 属 性 中 ， 没 有 任何 的 模型 数据 ， 这 
个 请 求 必须 要 目 己 计算 数据 。 

















执行 重 定向 
原始 请 求 重 定向 请 求 
模型 模型 
spitter=Spitter 察 





























图 7.1 模型 的 属性 是 以 请 求 属性 的 形式 存放 在 请 求 中 的 ， 在 重 定向 后 无 法 存活 














显然 ， 对 于 重 定 回来 次， 模型 并 不 能 用 来 传递 数据 。 但 是 我 们 也 有 一 些 
其 他 方案 ， 能 够 从 发 起 重 定 同 的 方法 传递 数据 给 处 理 重 定 同 方法 中 : 


。 使 用 URL 模 板 以 路 径 变量 和 /或 查询 参数 的 形式 传递 数据 ; 
。 通过 flash 属 性 发 送 数据 。 


首先 ， 我 们 看 一 下 Spring 如 何 帮助 我 们 通过 路 径 变量 和 /或 得 询 参数 的 形 
式 传递 数据 。 




















7.5.1 通过 UREL 模板 进行 重 定 辐 


通过 路 径 变 量 和 查询 参数 传递 数据 看 起 来 非常 简单 。 例 如 ， 在 程序 清单 
5.19 中 ， 我 们 以 路 径 变 量 的 形式 传递 了 新 创建 spitter 的 username。 但 
是 按照 现在 的 写法 ，username 的 值 是 直接 连接 到 重 定 向 string 上 的 。 
这 能 够 正常 运行 ， 但 是 还 远 远 不 能 说 没有 问题 。 当 构建 URL 或 SQL 查询 
语句 的 时 候 ， 使 用 String 连 接 是 很 危险 的 。 


return "redirect:/spitter/{username}"; 


除了 连接 String 的 方式 来 构建 重 定 辣 URL，Spring 还 提供 了 使 用 模板 的 方 
式 来 定义 重 定向 URL。 例 如 ， 在 程序 清单 5.19 
中 ，processRegistration() 方 法 的 最 后 一 行 可 以 改写 为 如 下 的 形 
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@RequestMapping(value="/register", method=POST) 
public String processRegistration( 
Spitter spitter, Model model) { 
spitterRepository.save(spitter) ; 


model.addAttribute("username", spitter.getUsername()); 
return "redirect:/spitter/{username}"; 


} 





现在 ，username 作 为 占 位 符 填 充 到 了 URL 模 板 中 ， 而 不 是 直 接连 接 到 
重 定向 String 中 ， 所 以 username 中 所 有 的 不 安全 字符 都 会 进行 转 义 。 
这 样 会 更 加 安全 ， 这 里 允许 用 户 输入 任何 想 要 的 内 容 作为 username， 
并 会 将 其 附加 到 路 径 上 。 


除 此 之 外 ， 模 型 中 所 有 其 他 的 原始 类 型 值 都 可 以 添加 到 URL 中 作为 得 询 
参数 。 作 为 样 例 ， 假 设 除 了 username 以 外 ， 模 型 中 还 要 包含 新 创建 


Spitter 对 象 的 id 属 性 ， 那 processRegistration() 方 法 可 以 改写 为 
如 下 的 形式 : 


@RequestMapping(value="/register", method=POST) 
public String processRegistration( 
Spitter spitter, Model model) { 
spitterRepository.save(spitter); 


model.addAttribute("username", spitter.getUsername()); 
model.addAttribute("spitterId", spitter.getId()); 
return "redirect:/spitter/{username}"; 





所 返回 的 重 定向 String 并 没有 太 大 的 变化 。 但 是 ， 因 为 模型 中 的 
spitterId 属 性 没有 匹配 重 定向 URL 中 的 任何 占 位 符 ， 所 以 它 会 自动 以 
查询 参数 的 形式 附加 到 重 定向 URL 上 。 


如 果 username 属 性 的 值 是 habuma 并 且 spitterId 属 性 的 值 是 42， 那 么 
结果 得 到 的 重 定向 URL 路 径 将 会 是 “/spitter/habuma? 
spitterId=42”。 


通过 路 径 变 量 和 仁 询 参数 的 形式 跨 重 定 癌 传递 数据 是 很 镜 单 直接 的 方 
式 ， 但 它 也 有 一 定 的 限制 。 它 只 能 用 来 肥 送 简单 的 值 ， 如 String 和 数 
字 的 值 。 在 URL 中 ， 并 没有 办 法 发 送 更 为 复杂 的 值 ， 但 这 正 是 flash 属 
性 能 够 提供 帮助 的 领域 。 


7.5.2 ”使 用 flash 属 性 


假设 我 们 不 想 在 重 定向 中 发 送 username 或 ID 了 ， 而 是 要 发 送 实际 的 
Spitter 对 象 。 如 果 我 们 只 发 送 ID 的 话 ， 那 么 处 理 重 定向 的 方法 还 需要 
从 数据 库 中 查找 才能 得 到 spitter 对 象 。 但 是 ， 在 重 定向 之 前 ， 我 们 其 
实 已 经 得 到 了 Spitter 对 象 。 为 什么 不 将 其 发 送 给 处 理 重 定向 的 方法 ， 
并 将 其 展现 出 来 呢 ? 


Spitter 对 象 要 比 String 和 int 更 为 复杂 。 因 此 ， 我 们 不 能 像 路 径 变 量 
或 查询 参数 那么 容易 地 发 送 Spitter 对 象 。 它 只 能 设置 为 模型 中 的 属 
性 。 




















但 是 ， 正 如 我 们 前 面 所 讨论 的 那样 ， 模 型 数据 最 终 是 以 请 求 参 数 的 形式 
复制 到 请 求 中 的 ， 当 重 定向 发 生 的 时 候 ， 这 些 数据 就 会 丢失 。 因 此 ， 我 





们 需要 将 Spitter 对 象 放 到 一 个 位 置 ， 使 其 能 够 在 重 定 癌 的 过 程 中 存活 
下 水 


有 个 方案 是 将 Spitter 放 到 会 话 中 。 会 话 能 够 长 期 存在 ， 并 且 能 够 跨 多 
个 请 求 。 所 以 我 们 可 以 在 重 定 辣 发 生 之 前 将 spitter 放 到 会 话 中 ， 并 在 
重 定 同 后 ， 从 会 话 中 将 其 取出 。 当 然 ， 我 们 还 要 负责 在 重 定 癌 后 在 会 话 
中 将 其 清理 挥 。 


实际 上 ，Spring 也 认为 将 跨 重 定 辐 存活 的 数据 放 到 会 话 中 是 一 个 很 不 
错 的 方式 。 但 是 ，Spring 认 为 我 们 并 不 需要 管理 这 些 数据 ， 相 

反 ，Spring 提 供 了 将 数据 发 送 为 flash 属 性 (flash attribute 〉 的 功能 。 按 
I flash 属 性 会 一 直 携 市 这 些 数 据 直 到 下 一 次 请 求 ， 然 后 才 会 消 








Spring 提 供 了 通过 RedirectAttributes 设 置 flash 属 性 的 方法 ， 这 是 
Spring 3.1 引 入 的 Mode1 的 一 个 子 接口 。RedirectAttributes 提 供 了 
Model 的 所 有 功能 ， 除 此 之 外 ， 还 有 几 个 方法 是 用 来 设置 flash 属 性 的 。 


具体 来 讲 ，RedirectAttributes 提 供 了 一 组 addFlashAttribute() 
方法 来 添加 flash 属 性 。 重 新 看 一 下 processRegistration() 方 法 ， 我 
们 可 以 使 用 addFlashAttribute() 将 Spitter 对 象 添加 到 模型 中 : 


@RequestMapping(value="/register", method=POST) 
public String processRegistration( 
Spitter spitter, RedirectAttributes model) { 
spitterRepository.save(spitter); 


model.addAttribute("username", spitter.getUsername()); 
model.addFlashAttribute("spitter", spitter); 
return "redirect:/spitter/{username}"; 





在 这 里 ， 我 们 调用 了 addFlashAttribute() 方 法 ， 并 将 spitter 作 为 
key，Spitter 对 象 作为 值 。 男 外 ， 我 们 还 可 以 不 设置 key 参 数 ， 让 key 
根据 值 的 类 型 自行 推 新 得 出 : 


model.addFlashAttribute(spitter); 


因为 我 们 传递 了 一 个 spitter 对 象 给 addFlashAttribute( ) 方 法 ， 所 
以 推 呆 得 到 的 key 将 会 是 spitter。 


在 重 定向 执行 之 前 ， 所 有 的 flash 属 性 都 会 复制 到 会 话 中 。 在 重 定向 后 ， 
存在 会 话 中 的 flash 属 性 会 被 取出 ， 并 从 会 话 转移 到 模型 之 中 。 处 理 重 定 
向 的 方法 就 能 从 模型 中 访问 Spitter 对 象 了 ， 就 像 获 取 其 他 的 模型 对 象 一 
样 。 图 7.2 闭 述 了 它 是 如 何 运 行 的 。 





执行 重 定向 
原始 请 求 重 定向 请 求 
Flash 属 性 模型 
spitter=Spitter spitter=Spitter 
会 话 





图 7.2 flash 属 性 保存 在 会 话 中 ， 然 后 再 放 到 模型 中 ， 
因此 能 够 在 重 定向 的 过 程 中 存活 


为 了 完成 flash 属 性 的 流程 ， 如 下 展现 了 更 新 版 本 的 
showSpitterProfile() 方 法 ， 在 从 数据 库 中 查找 之 前 ， 它 会 首先 从 模 
型 中 检查 Spitter 对 象 : 


























@RequestMapping(value="/{username}", method=GET) 
public String showSpitterProfile( 
@PathVariable String username, Model model) { 
if (!model.containsAttribute("spitter")) { 


model.addAttribute( 
spitterRepository.findByUsername(username ) ) ; 


} 


return "profile"; 


} 














可 以 看 到 ，showSspitterProfile() 方 法 所 做 的 第 一 件 事 就 是 检查 是 否 
存 有 key 为 spitter 的 model 属 性 。 如 果 模 型 中 包含 spitter 属 性 ， 那 就 
什么 都 不 用 做 了 。 这 里 面包 含 的 Spitter 对 象 将 会 传递 到 视图 中 进行 泻 
染 。 但 是 如 果 模 型 中 不 包含 spitter 属 性 的 话 ， 那 

么 showSpitterProfile( ) 将 会 从 Repository 中 查找 spitter， 并 将 其 
存放 到 模型 中 。 


7.6 ”小结 


在 Spring 中 ， 总 是 会 有 “还 没有 结束 ”的 感觉 : 更 多 的 特性 、 更 多 的 选择 
以 及 实现 开发 目标 的 更 多 方式 。Spring MVC 有 很 多 功能 和 技巧 。 


当然 ，Spring MVC 的 环境 搭建 是 有 多 种 可 选 方案 的 一 个 领域 。 在 本 章 
中 ， 我 们 首先 看 了 一 下 搭建 Spring MVC 中 DispatcherServlet 和 和 
ContextLoaderListener 的 多 种 方式 。 我 们 还 看 到 了 如 何 调 

整 DispatcherServlet 的 注册 功能 以 及 如 何 注 册 自 定义 的 Servlet 和 
Filter。 如 条 你 需要 将 应 用 部 署 到 更 老 的 应 用 服务 器 上 ， 我 们 还 快速 了 解 
了 如 何 使 用 web.xml 声 明 DispatcherServlet 和 
ContextLoaderListener。 


然后 ， 我 们 了 解 了 如 何 处 理 Spring MVC 控 制 器 所 抛 出 的 异常 。 尽 管 带 
有 @RequestMapping 注 解 的 方法 可 以 在 自身 的 代码 中 人 处理 异常 ， 但 是 
如 果 我 们 将 异常 处 理 的 代码 抽取 到 单独 的 方法 中 ， 那 么 控制 器 的 代码 会 


整洁 得 多 。 

















为 了 及 用 一 致 的 方式 处 理 通 用 的 任务 ， 包 括 在 应 用 的 所 有 控制 器 中 处 理 
异常 ，Spring 3.2 引 入 了 @ControllerAdvice， 它 所 创建 的 类 能 够 将 控 
制 器 的 通用 行为 抽取 到 同一 个 地 方 。 


最 后 ， 我 们 看 了 一 下 如 何 路 重 定 同 传 递 数据 ， 包 括 Spring 对 flash 属 性 的 
支持 : 类 似 于 模型 的 属性 ， 但 是 能 在 重 定向 后 存活 下 来 。 这 样 的 话 ， 就 
能 采用 非 癌 恰当 的 方式 为 POST 请 求 执行 一 个 重 定 癌 回应 ， 而 且 能 够 将 处 
人 的 模型 数据 传递 过 来 ， 然 后 在 重 定 同 后 使 用 或 展现 这 些 模 


如 果 你 还 有 疑惑 的 话 ， 那 么 可 以 告诉 你 ， 这 就 是 我 所 说 的 “更 多 的 功 
能 ”! 其 实 ， 我 们 并 没有 讨论 到 Spring MVC 的 每 个 方面 。 我 们 将 会 在 第 
16 章 中 重新 讨论 Spring MVC， 到 时 你 会 看 到 如 何 使 用 它 来 创建 REST 
APT。 








但 现在 ， 我 们 将 会 暂时 放下 Spring MVC， 看 一 下 Spring Web Flow， 这 
是 一 个 构建 在 Spring MVC 之 上 的 流程 框架 ， 它 能 够 引导 用 户 执 行 一 系列 
问 导 步骤 。 


第 8 章 ”使 用 Spring Web Flow 


本 章 内 容 : 


。 创建 会 话 式 的 Web 应 用 程序 
。 定义 流程 状态 和 行为 
。 你 护 Web 流 程 


关于 互联 网 ， 很 奇妙 的 一 件 事 束 是 它 很 容易 让 你 迷失 。 有 如 此 之 多 的 内 
容 可 以 查看 和 阅读 ， 而 超 链接 是 互联 网 强大 魔力 的 核心 。 无 怪 乎 将 其 称 
为 网 ， 正 如 蜂 蛛 织 出 的 网 ， 它 会 将 经 过 的 任何 东西 困 住 。 我 必须 承认 : 
之 所 以 在 编写 此 书 时 花费 了 如 此 多 的 时 间 ， 其 中 的 一 个 原因 就 是 我 曾经 
迷失 在 维基 百科 无 休 无 止 的 链接 之 中 。 


有 了 时候 ，Web 应 用 程序 需要 控制 网 络 冲 浪 者 的 方 铝 ， 引 导 他 们 一 步 步 地 
访问 应 用 。 比 较 典 型 的 例子 就 是 电子 商务 站 点 的 结账 流程 ， 从 购物 车 开 
始 ， 应 用 程序 会 引导 你 依次 经 过 派送 详情 、 账 单 信息 以 及 最 终 的 订单 确 


Spring Web Flow 是 一 个 Web 框 架 ， 它 适用 于 元 素 按 规定 流程 运行 的 程 
序 。 在 本 章 中 ， 我 们 将 会 探索 Spring Web Flow 并 了 解 它 如 何 应 用 于 
Spring Web 框 架 平 台 。 


其 实 我 们 可 以 使 用 任何 Web 框 染 编写 流程 化 的 应 用 程序 。 我 曾经 看 到 过 
一 个 应 用 程序 ， 在 Struts 中 构建 了 特定 的 流程 。 但 是 这 样 就 没有 办 法 将 
流程 与 实现 分 开 了 ， 你 会 发 现 流 程 的 定义 分 散在 组 成 流程 的 各 个 元 素 
中 。 没 有 地 方 能 够 完整 地 描述 整个 流程 。 


Spring Web Flow 是 Spring MVC 的 扩展 ， 它 文 持 开 发 基于 流程 的 应 用 程 
序 。 它 将 流程 的 定义 与 实现 流程 行为 的 类 和 视图 分 离开 来 。 


在 介绍 Spring Web Flow 的 时 候 ， 我 们 将 暂时 放下 Spittr 样 例 并 使 用 生成 
披 院 订单 的 新 Web 应 用 程序 。 我 们 会 使 用 Spring Web Flow 来 定义 订单 流 


程 。 


使 用 Spring Web Flow 的 第 一 步 是 在 项 目 中 安装 它 。 让 我 们 从 这 里 开始 



































8.1 在 Spring 中 配置 Web Flow 


Spring Web Flow 是 构建 于 Spring MVC 基 础 之 上 的 。 这 意味 着 所 有 的 流 
程 请 求 都 需要 首先 经 过 Spring MVC 的 DispatcherServlet。 我 们 需要 
在 Spring 应 用 上 下 文中 配置 一 些 bean 来 处 理 流程 请 求 并 执行 流程 。 


现在 ， 还 不 支持 在 Java 中 配置 Spring Web Flow， 所 以 我 们 别 无 选择 ， 只 
能 在 XML 中 对 其 进行 配置 。 有 一 些 bean 会 使 用 Spring Web Flow 的 Spring 
配置 文件 命名 空间 来 进行 声明 。 因 此 ， 我 们 需要 在 上 下 文 定义 XML 文 
件 中 添加 这 个 命名 空间 声明 : 





<?xml version="1.60" encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/26601/XMLSchema-instance" 
xmlns:flow="http://www.springframework.org/schema/webflow-config" 
xsi:schemaLocation= 


"http://www.springframework.org/schema/webflow-config 
http://www.springframework.org/schema/webflow-config/[CA] 
spring-webflow-config-2.3.xsd 

http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 





在 声明 了 命名 空间 之 后 ， 我 们 束 为 装配 Web Flow 的 bean 做 好 了 准备 ， 让 
我 们 从 流程 执行 器 (flow executor) 开始 吧 。 

8.1.1 ”装配 流程 执行 器 

正如 其 名 字 所 示 ， 流 程 执行 器 (flow executor) 驱动 流 程 的 执行 。 当 用 
户 进 入 一 个 流程 时 ， 流 程 执行 器 会 为 用 户 创 建 并 启动 一 个 流程 执行 实 
例 。 当 流程 暂停 的 时 候 《〈 如 为 用 户 展示 视图 时 ) ， 流 程 执行 器 会 在 用 户 
执行 操作 后 恢复 流程 。 


在 Spring 中 ，<flow:flow-executor> 元 素 会 创建 一 个 流程 执行 器 : 


<flow:flow-executor id="flowExecutor" /> 


尽管 流程 执行 器 负责 创建 和 执行 流程 ， 但 它 并 不 负责 加 载 流程 定义 。 这 
个 责任 落 在 了 流程 注册 表 (flow registry) 身上 ， 接 下 来 我 们 会 创建 它 。 


8.1.2 ”配置 流程 注册 表 


流程 注册 表 (flow registry〉 的 工作 是 加 载 流程 定义 并 让 流程 执行 器 能 
够 使 用 它们 。 我 们 可 以 在 Spring 中 使 用 <flow:flow-registry> 配 置 流 
程 注 册 表 ， 如 下 所 示 : 


<flow:flow-registry id="flowRegistry" base-path="/WEB-INF/flows"> 


<flow:flow-location-pattern value="*-flow.xml" /> 
</flow:flow-registry> 





在 这 里 的 声明 中 ， 流 程 注册 表 会 在 “WEB-INF/flows” 目 录 下 查找 流程 定 
义 ， 这 是 通过 base-path 属 性 指明 的 。 依 据 <flow:flow-location- 
pattern> 元 素 的 值 ， 任 何 文件 名 以 “flow.xzml 结 尾 的 XML 文件 都 将 视 
为 流程 定义 。 


所 有 的 流程 都 是 通过 其 ID 来 进行 引用 的 。 这 里 我 们 使 用 了 <flow:flow- 
ocation-pattern> 元 素 ， 流 程 的 ID 就 是 相对 于 base-path 的 路 径 一 一 
J 的 路 径 。 图 8.1 展 示 了 示例 中 的 流程 ID 是 如 何 计 算 





流程 注册 表 流程 定义 
基本 路 径 


/WEB-INF/flows/order/order-flow.xml 


流程 ID 





图 8.1 在 使 用 流程 定位 模式 的 时 候 ， 
流程 定义 文件 相对 于 基本 路 径 的 路 径 将 被 用 作 流 程 的 ID 

作为 另 一 种 方式 ， 我 们 可 以 去 除 base-path 属 性 ， 而 显 式 声明 流程 定义 

文件 的 位 置 : 














<flow:flow-registry id="flowRegistry"> 


<flow:flow-location path="/WEB-INF/flows/springpizza.xml" /> 
</flow:flow-registry> 





在 这 里 ， 使 用 了 <flow:flow-location> 而 不 是 <flow: flow- 


location-pattern>，path 属 性 直接 指明 了“/WEB- 
INF/flows/springpizza.xml" 作 为 流程 定义 。 当 我 们 这 样 配置 的 话 ， 流 程 
的 ID 是 从 流程 定义 文件 的 文件 名 中 获得 的 ， 在 这 里 就 是 springpizza。 


如 果 你 希望 更 显 式 地 指定 流程 DD， 那 你 可 以 通过 <flow:flow- 
location> 元 素 的 id 属 性 来 进行 设置 。 例 如 ， 要 将 pizza 作 为 流程 ID， 
可 以 像 这 样 配 置 : 








<flow:flow-registry id="flowRegistry"> 
<flow:flow-location id="pizza" 


path="/WEB-INF/flows/springpizza.xml" /> 
</flow:flow-registry> 





8.1.3 ”处 理 流程 请 求 


我 们 在 前 一 章 曾经 看 到 ，DispatcherServlet 一 般 将 请 求 分 发 给 控制 
器 。 但 是 对 于 流程 而 言 ， 我 们 需要 一 个 FlowHandlerMapping 来 帮助 
DispatcherServlet 将 流程 请 求 发 送 给 Spring Web Flow。 在 Spring 应 用 
上 下 文中 ，FlowHandlerMapping 的 配置 如 下 : 








<bean class= 
"org.springframework.webflow.mvc.servlet.FlowHandlerMapping"> 


<property name="flowRegistry" ref="flowRegistry" /> 
</bean> 





你 可 以 看 到 ，FlowHandlerMapping 装 配 了 流程 注册 表 的 引用 ， 这 样 它 
惑 能 知道 如 何 将 请 求 的 URL 匹 配 到 流程 上 。 例 如 ， 如 有 果 我 们 有 一 个 ID 
为 pizza 的 流程 ，FlowHandlerMapping 就 会 知道 如 果 请 求 的 URL 模 式 
《相对 于 应 用 程序 的 上 下 文 路 径 ) 是 %pizza” 的 话 ， 就 要 将 其 匹配 到 这 


个 流程 上 。 


然而 ，FlowHandlerMapping 的 工作 仅仅 是 将 流程 请 求 定 同 到 Spring 
Web Flow 上 ， 啊 应 请 求 的 

是 FlowHandlerAdapter。F1lowHandlerAdapter 等 同 于 Spring MVC 的 
控制 器 ， 它 会 啊 应 发 送 的 流程 请 求 并 对 其 进行 处 

理 。FlowHandlerAdapter 可 以 像 下 面 这 样 装配 成 一 个 Spring bean， 如 
下 所 示 : 


<bean class= 








"org.springframework.webflow.mvc.servlet.FLowHandlerAdapter"> 
<property name="flowExecutor" ref="flowExecutor" /> 
</bean> 





这 个 处 理 适配器 是 DispatcherServlet 和 Spring Web Flow 之 间 的 桥 
梁 。 它 会 处 理 流程 请 求 并 管理 基于 这 些 请 求 的 流程 。 在 这 里 ， 它 装配 了 
流程 执行 器 的 引用 ， 而 后 者 是 为 所 处 理 的 请 求 执行 流程 的 。 

我 们 已 经 配置 了 Spring WebFlow 所 需 的 bean 和 组 件 。 剩 下 束 是 真正 定义 


流程 了。 我 们 随后 将 会 进行 这 项 工作 。 但 首先 ， 让 我 们 先 了 解 一 下 组 成 
流程 的 元 素 。 


8.2 ”流程 的 组 件 


在 Spring Web Flow 中 ， 流 程 是 由 三 个 主要 元 素 定 义 的 : 状态 、 转 移 和 流 
程 数据 。 状 态 《〈State) 古 流程 中 事件 发 生 的 地 点 。 如 采 你 将 流程 想象 成 
公路 旅行 ， 那 状态 就 是 路 途上 的 城镇 、 路 边 饭店 以 及 风景 点 。 流 程 中 的 
状态 是 业务 逻辑 执行 、 做 出 决策 或 将 页 面 展现 给 用 户 的 地 方 ， 而 不 是 在 
公路 旅行 中 买 Doritos 警 片 和 健 怡 可 乐 的 所 在 。 


如 来 流程 状态 就 像 公 路 旅行 中 停 下 来 的 地 点 ， 那 转移 (transition〉 束 是 
0 这 些 点 的 公路 。 在 流程 中 ， 你 通过 转移 的 方式 从 一 个 状态 到 另 一 个 
状态 


当 你 在 城 缠 之 间 旅 行 的 时 候 ， 你 可 能 要 买 一 些 纪念 品 ， 留 下 一 些 记忆 并 
在 路 上 取 一 些 空 的 零食 袋 。 类 似 地 ， 在 流程 处 理 中 ， 它 要 收集 一 些 数 
据 : 流程 的 当前 状况 我 很 想 将 其 称 为 流程 的 状态 ， 但 是 在 我 们 讨论 流 
程 的 时 候 状态 〈state) 已 经 有 了 另外 的 含义 。 


让 我 们 仔细 看 一 下 在 Spring Web Flow 中 这 三 个 元 素 是 如 何 定义 的 。 

8.2.1 状态 

Spring Web Flow 定 义 了 五 种 不 同类 型 的 状态 ， 如 表 8.1 所 示 。 通 过 选择 
Spring Web Flow 的 状态 几乎 可 以 把 任意 的 安排 功能 构造 成 会 话 式 的 Web 


应 用 。 尽 管 并 不 是 所 有 的 流程 都 需要 表 8.1 所 描述 的 状态 ， 但 最 终 你 可 
能 会 经 常 使 用 它们 中 的 大 多 数 。 


表 8.1 Spring Web Flow 可 供 选 择 的 状态 





来 做 什么 的 





行为 状态 是 流程 逻辑 发 生 的 地 方 











决策 状态 将 流程 分 成 两 个 方 铝 ， 它 会 基于 流程 数据 的 评估 结果 确 
定 流 程 方 癌 




















结束 〈End) 结束 状态 是 流程 的 最 后 一 站 。 一 旦 进入 End 状 态 ， 流 程 就 会 终止 








病程 
流程 状态 会 在 当前 正在 运行 的 流程 上 下 文中 启动 一 个 新 的 流程 
(Subflow) 



































视图 (View) 视图 状态 会 暂停 流程 并 邀请 用 户 参 与 流程 


稍 后 我 们 将 会 看 到 如 何 将 这 些 不 同类 型 的 状态 组 合 起 来 形成 一 个 完整 的 
流程 。 但 首先 ， 让 我 们 了 解 一 下 这 些 流程 元 素 在 Spring Web Flow 定 义 中 
是 如 何 表现 的 。 

视图 状态 


视图 状态 用 于 为 用 户 展现 信息 并 使 用 户 在 流程 中 发 挥 作用 。 实 际 的 视图 
实现 可 以 是 Spring 文 持 的 任意 视图 类 型 ， 但 通常 是 用 JSP 来 实现 的 。 


在 流程 定义 的 XML 文件 中 ，<view-state> 用 于 定义 视图 状态 : 





<view-state id="welcome" /> 


在 这 个 简单 的 示例 中 ，id 属 性 有 两 个 含义 。 它 在 流程 内 标示 这 个 状态 。 
除 此 以 外 ， 因 为 在 这 里 没有 在 其 他 地 方 指 定 视 图 ， 所 以 它 也 指定 了 流程 
到 达 这 个 状态 时 要 展现 的 逻辑 视图 名 为 welcome。 





<View-state id="welcome" view="greeting" /> 


如 果 流 程 为 用 户 展 现 了 一 个 表单 ， 你 可 能 希望 指明 表单 所 绑 定 的 对 象 。 
为 了 做 到 这 一 点 ， 可 以 设置 mode1 属 性 : 


<View-state id="takePayment" model="flowScope.paymentDetails"/> 





这 里 我 们 指定 takePayment 视 图 中 的 表单 将 绑 定 流程 作用 域内 的 
paymentDetails 对 象 。《〈 稍 后 ， 我 们 将 会 更 详细 地 介绍 流程 作用 域 和 


数据 。) 

行为 状态 

视图 状态 会 涉及 到 流程 应 用 程序 的 用 户 ， 而 行为 状态 则 是 应 用 程序 上 自身 
在 执行 任务 。 行 为 状态 一 般 会 触发 Spring 所 管理 bean 的 一 些 方法 并 根据 
方法 调用 的 执行 结果 转移 到 另 一 个 状态 。 


在 流程 定义 XML 中 ， 行 为 状态 使 用 <action-state> 元 素来 声明 。 这 里 
是 一 个 例子 : 


<action-state id="saveOrder"> 
<evaluate expression="pizzaFlowActions.saveOrder(order)" /> 


<transition to="thankYou"” /> 
</action-state> 





尽管 不 是 严格 需要 的 ， 但 是 <action-state> 元 素 一 般 都 会 有 一 个 
<evaluate> 作 为 子 元 素 。<evaluate> 元 素 给 出 了 行为 状态 要 做 的 事 
情 。expression 属 性 指定 了 进入 这 个 状态 时 要 评估 的 表达 式 。 在 本 示 
例 中 ， 给 出 的 expression 是 SpEL 表 达 式 ， 它 表明 将 会 找到 ID 

为 pizzaFlowActions 的 bean 并 调用 其 saveOrder() 方 法 。 


Spring Web Flow 与 表达 式 语言 


在 这 几 年 以 来 ，Spring Web Flow 在 选择 的 表达 式 语言 方面 ， 经 过 了 一 些 
变化 。 在 1.0 版 本 的 时 候 ，Spring Web Flow 使 用 的 是 对 象 图 导航 语言 

(Object-Graph Navigation Language ，OGNL)。 随 后 的 2.0 版 本 又 换 成 
了 统一 表达 式 语言 (Unified Expression Language ，Unified EL ) 。 在 2.1 
版 本 中 ，Spring Web Flow 使 用 的 是 SpEL。 


尽管 可 以 使 用 上 述 的 任意 表达 式 语言 来 配置 Spring Web Flow， 但 SpEL 
是 默认 和 推荐 使 用 的 表达 式 语 言 。 因 此 ， 当 定义 流程 的 时 候 ， 我 们 会 选 
择 使 用 SpEL， 和 忽略 挥 其 他 的 可 选 方 案 。 


决策 状态 
有 可 能 流程 会 完全 按照 线性 执行 ， 从 一 个 状态 进入 为 一 个 状态 ， 没 有 其 


他 的 蔡 代 路 线 。 但 是 更 常见 的 情况 是 流程 在 某 一 个 点 根据 流程 的 当前 情 
况 进 入 不 同 的 分 文 。 


决策 状态 能 够 在 流程 执行 时 产生 两 个 分 支 。 决 策 状 态 将 评估 一 个 
Boolean 类 型 的 表达 式 ， 然 后 在 两 个 状态 转移 中 选择 一 个 ， 这 要 取决 于 
表达 式 会 计算 出 true 还 是 false。 在 XML 流 程 定义 中 ， 决 策 状态 通过 
<decision-state> 元 素 进 行 定 义 。 典 型 的 决策 状态 示例 如 下 所 示 : 


<decision-state id="checkDeliveryArea"> 
<if test="pizzaFlowActions.checkDeliveryArea(customer.zipCode)" 


then="addCustomer" 
else="deliveryWarning" /> 
</decision-state> 








你 可 以 看 到 ，<decision-state> 并 不 是 独立 完成 工作 的 。<if> 元 素 是 
决策 状态 的 核心 。 这 是 表达 式 进 行 评估 的 地 方 ， 如 果 表 达 式 结果 

为 true， 流 程 将 转移 到 then 属 性 指定 的 状态 中 ， 如 果 结 果 为 false， 流 
程 将 会 转移 到 else 属 性 指定 的 状态 中 。 


子 流程 状态 


你 可 能 不 会 将 应 用 程序 的 所 有 逻辑 写 在 一 个 方法 中 ， 而 是 将 其 分 散 到 多 
个 类 、 方 法 以 及 其 他 结构 中 。 

同样 ， 将 流程 分 成 独立 的 部 分 是 个 不 错 的 主意 。<subflow-state> 人 允 
许 在 一 个 正在 执行 的 流程 中 调用 男 一 个 流程 。 这 类 似 于 在 一 个 方法 中 调 
用 鸭 研 和， 


<subflow-state> 可 以 这 样 声明 : 











<subflow-state id="order" subflow="pizza/order"> 
<input name="order" value="order"/> 


<transition on="orderCreated" to="payment" /> 
</subflow-state> 





在 这 里 ，<input> 元 素 用 于 传递 订单 对 象 作为 子 流程 的 输入 。 如 果子 流 
时 结束 的 <end-state> 状 态 ID 为 orderCreated， 那 么 流程 将 会 转移 到 
名 为 payment 的 状态 。 


在 这 里 ， 我 有 点 超出 进度 了 ， 我 们 还 没有 讨论 到 <end-state> 元 素 和 转 
移 。 我 们 很 快 就 会 在 8.2.2 小 节 介 绍 转移 。 对 于 结束 状态 ， 这 正 是 接 下 来 


要 介绍 的 。 








结束 状态 


最 后 ， 所 有 的 流程 都 要 结束 。 这 款 是 当 流程 转移 到 结束 状态 时 所 做 
的 。<end-state> 元 系 指 定 了 流程 的 结束 ， 它 一 般 会 是 这 样 声明 的 : 


<end-state id="customerReady”/> 


流程 会 结束 。 接 下 来 会 发 生 什么 取决 于 几 个 
因素 : 


。 如 果 结 束 的 流程 是 一 个 子 流程 ， 那 调用 它 的 流程 将 会 从 <subflow- 
state> 处 继续 执行 。<end-state> 的 ID 将 会 用 作 事 件 触 发 从 
<subflow-state> 开 始 的 转移 。 

如 果 <end-state> 设 置 了 view 属 性 ， 指 定 的 视图 将 会 被 泻 染 。 视 
图 可 以 是 相对 于 流程 路 径 的 视图 模板 ， 如 果 添 

加 “externalRedirect:” 前 级 的 话 ， 将 会 重 定 同 到 流程 外 部 的 页 
面 ， 如 果 添 加 “flowRedirect:” 将 重 定向 到 另 一 个 流程 中 。 

如 果 结 束 的 流程 不 是 子 流程 ， 也 没有 指定 view 属 性 ， 那 这 个 流程 只 
是 会 结束 而 已 。 浏 览 器 最 后 将 会 加 载 流 程 的 基本 URL 地 址 ， 当 前 已 
没有 活动 的 流程 ， 所 以 会 开始 一 个 新 的 流程 实例 。 


需要 意识 到 流程 可 能 会 有 不 止 一 个 结束 状态 。 子 流程 的 结束 状态 ID 确定 
了 激活 的 事件 ， 所 以 你 可 能 会 希望 通过 多 种 结束 状态 来 结束 子 流 程 ， 从 
而 能 够 在 调用 流程 中 触发 不 同 的 事件 。 即 使 不 是 在 子 流程 中 ， 也 有 可 能 
在 结束 流程 后 ， 根 据 流 程 的 执行 情况 有 多 个 显示 页 面 供 选择 。 


现在 ， 已 经 看 完了 流程 中 的 各 个 状态 ， 我 们 应 当 看 一 下 流程 是 如 何在 状 
让 我 们 看 看 如 何在 流程 中 通过 定义 转移 来 完成 道路 铺设 

















8.2.2 ”转移 


正如 我 在 前 面 所 提 到 的 ， 转 移 连接 了 流程 中 的 状态 。 流 程 中 除 结束 状态 
之 外 的 每 个 状态 ， 至 少 都 需要 一 个 转移 ， 这 样 就 能 够 知道 一 旦 这 个 状态 
完成 时 流程 要 去 向 哪里 。 状 态 可 以 有 多 个 转移 ， 分 别 对 应 于 当前 状态 结 
束 时 可 以 执行 的 不 同 的 路 径 。 


转移 使 用 <transition> 元 素来 进行 定义 ， 它 会 作为 各 种 状态 元 系 





(<action-state>、<view-state>、<subflow-state>) 的 子 元 
素 。 最 简单 的 形式 就 是 <transition> 元 素 在 流程 中 指定 下 一 个 状态 : 


<transition to="customerReady" /> 


属性 to 用 于 指定 流程 的 下 一 个 状态 。 如 果 <transition> 只 使 用 了 to 属 
性 ， 那 这 个 转移 就 会 是 当前 状态 的 默认 转移 选项 ， 如 宋 没 有 其 他 可 用 转 
移 的 话 ， 就 会 使 用 它 。 


更 常见 的 转移 定义 是 基于 事件 的 触 友 来 进行 的 。 在 视图 状态 ， 事 件 通 常 
会 是 用 户 采 取 的 动作 。 在 行为 状态 ， 事 件 是 评估 表达 式 得 到 的 结果 。 而 
在 子 流程 状态 ， 事 件 取决 于 子 流程 结束 状态 的 DD。 在 任意 的 事件 中 (这 
里 没有 任何 卜 义 )， 你 可 以 使 用 on 属性 来 指定 触发 转移 的 事件 : 




















<transition on="phoneEntered" to="lookupCustomer"/> 


在 本 例 中 ， 如 果 触 发 了 phoneEntered 事 件 ， 流 程 将 会 进 
入 lookupCustomer 状 态 。 


在 抛 出 异常 时 ， 流 程 也 可 以 进入 男 一 个 状态 。 例 如 ， 如 果 顾 客 的 记录 没 
有 找到 ， 你 可 能 希望 流程 转移 到 一 个 展现 注册 表单 的 视图 状态 。 以 下 的 
代码 片段 显示 了 这 种 类 型 的 转移 : 


<transition 
on-exception= 


"com.springinaction.pizza.service.CustomerNotFoundException" 
to="registrationForm" /> 





属性 on-exception 类 似 于 on 属性 ， 只 不 过 它 指定 了 要 发 生 转 移 的 异常 
而 不 是 一 个 事件 。 在 本 示例 中 ，CustomerNotFoundException 异 常 将 
导致 流程 转移 到 registrationForm 状 态 。 


全 局 转移 
在 创建 完 流 程 之 后 ， 你 可 能 会 发 现 有 一 些 状态 使 用 了 一 些 通用 的 转移 。 


例如 ， 如 果 在 整个 流程 中 到 处 都 有 如 下 <transition> 的 话 ， 我 一 点 也 
不 感觉 意外 : 





<transition on="cancel" to="endState" /> 


与 其 在 多 个 状态 中 都 重复 通用 的 转移 ， 我 们 可 以 将 <transition> 元 素 
a 把 它们 定义 为 全 局 转移 。 例 
D: 


<global-transitions> 
<transition on="cancel" to="endState" /> 


</global-transitions> 





0 
移 。 


我 们 已 经 讨论 过 了 状态 和 转移 。 在 我 们 开始 编写 流程 之 前 ， 让 我 们 看 一 
下 流程 数据 ， 这 是 Web 演 程 三 元 系 中 的 男 一 个 成 员 。 


8.2.3 ”流程 数据 


如 末 你 曾经 玩 过 那 种 老式 的 基于 文字 的 冒险 游戏 的 话 ， 那 么 当 从 一 个 地 
方 转移 到 为 一 个 地 方 时 ， 你 会 偶尔 友 现 散布 在 周围 的 一 些 东 西 ， 你 可 以 
把 它们 捡 起 来 并 带 上 。 有 时 候 ， 你 会 马上 需要 一 件 东 西 。 其 他 的 时 候 ， 
你 会 在 整个 游戏 过 程 中 带 着 这 些 东 西 而 不 知道 它们 是 做 什么 用 的 一 一 直 
到 你 到 达 游 戏 结束 的 时 候 才 会 及 现 它 是 真正 有 用 的 。 

在 很 多 方面 ， 流 程 与 这 些 冒险 游戏 是 很 类 似 的 。 当 流程 从 一 个 状态 进行 
到 为 一 个 状态 时 ， 它 会 带 走 一 些 数据 。 有 了 时候， 这 些 数据 只 需要 很 短 的 
时 间 (可 能 只 要 展现 页 面 给 用 户 )。 有 了 时候， 这 些 数据 会 在 整个 流程 中 
传递 并 在 流程 结束 的 时 候 使 用 。 

声明 变量 

流程 数据 保存 在 变量 中 ， 而 变量 可 以 在 流程 的 各 个 地 方 进 行 引用 。 它 能 
够 以 多 种 方式 创建 。 在 流程 中 创建 变量 的 最 简单 形式 是 使 用 <var> 元 


人 ~* 











<var name="customer" class="com.springinaction.pizza.domain.Customer"/> 





这 里 ， 创 建 了 一 个 新 的 Customer 实 例 并 将 其 放 在 名 为 customer 的 变量 


中 。 这 个 变量 可 以 在 流程 的 任意 状态 进行 访问 。 


作为 行为 状态 的 一 部 分 或 者 作为 视图 状态 的 入 口 ， 你 有 可 能 会 使 
用 <evaluate> 元 素来 创建 变量 。 例 如 : 


<evaluate result="viewScope.toppingsList" 





expression="T(com.springinaction.pizza.domain.Topping).asList()" /> 


在 本 例 中 ，<evaluate> 元 素 计算 了 一 个 表达 式 〈(SpEL 表 达 式 ) 并 将 结 
果 放 到 了 名 为 toppingsList 的 变量 中 ， 这 个 变量 是 视图 作用 域 的 (我 
们 将 会 在 稍 后 介绍 关于 作用 域 的 更 多 概念 ) 。 
类 似 地 ，<set> 元 素 也 可 以 设置 变量 的 值 : 


<Sset name="flowScope.pizza" 





value="new com.springinaction.pizza.domain.Pizza()" /> 


<set> 元 素 与 《evaluate> 元 素 很 类 似 ， 都 是 将 变量 设置 为 表达 式 计算 
的 结果 。 这 里 ， 我 们 设置 了 一 个 流程 作用 域内 的 pizza 变 量 ， 它 的 值 
是 Pizza 对 象 的 新 实例 。 


当 我 们 在 8.3 小 节 开 始 构建 真实 工作 的 Web 流 程 时 ， 你 会 看 到 这 些 元 对 是 
如 何 具体 应 用 在 实际 流程 中 的 。 但 首先 ， 网 下 变量 的 流程 作用 
域 、 视 图 作用 域 以 及 其 他 的 一 些 作 用 域 是 什么 意思 。 


定义 流程 数据 的 作用 域 
流程 中 携带 的 数据 会 拥有 不 同 的 生命 作用 域 和 可 见 性 ， 这 取 雇 于 保存 数 


ee Spring Web Flow 定 义 了 五 种 不 同 作 用 域 ， 如 表 
8.2 所 示 。 








表 8.2 ”Spring Web Flow 的 作用 域 














范 国 j 域 和 可 见 性 












































;| 最 高 层级 的 流程 开始 时 创建 ， 在 最 高 层级 的 流程 结束 时 销毁 。 被 最 记 
层级 的 流程 和 其 所 有 的 子 流程 所 共享 
































Flow 有 在 流程 结束 时 销毁 。 只 有 在 创建 它 的 流程 中 是 可 
网民 

















流程 时 创建 ， 在 流程 返回 时 销毁 


























当 流 程 开始 时 创建 ， 在 流程 结束 时 销毁 。 在 视图 状态 泻 染 后 ， 它 也 会 





























当 进 入 视图 状态 时 创建 ， 当 这 个 状态 退 
可 见 的 











当 使 用 <var> 元 素 声明 变量 时 ， 变 量 始 终 是 流程 作用 域 的 ， 也 就 是 在 定 
义 变 量 的 流程 内 有 效 。 当 使 用 <set> 或 <cevaluate> 的 时 候 ， 作 用 域 通 
过 name 或 result 属 性 的 前 级 指定 。 例 如 ， 将 一 个 值 赋 给 流程 作用 域 的 
theAnswer 变 量 : 





<set name="flowScope.theAnswer" value="42"/> 


到 目前 为 止 ， 我 们 已 经 看 到 了 了 Web 流程 的 所 有 原材料 。 是 时 候 将 其 组 装 
起 来 形成 一 个 成 熟 且 完整 功能 的 Web 流程 了 。 当 我 们 这 样 做 的 时 候 ， 请 
睁 大 你 的 眼睛 观察 ， 比 如 我 是 如 何 将 数据 存储 在 各 作用 域 的 变量 中 的 。 


8.3 组 合 起 来 : 披萨 流程 


正如 我 在 本 章 前 面 所 提 到 的 ， 我 们 将 暂时 不 用 Spittr 应 用 程序 。 取 而 代 
之 ， 我 们 被 要 求 做 一 个 在 线 的 披萨 订购 应 用 ， 饥 饿 的 Web 访 问 者 可 以 在 
这 里 订购 他 们 所 喜欢 的 意大利 铂 。 


实际 上 上， 订购 披 辽 的 过 程 可 以 很 好 地 定义 在 一 个 流程 中 。 我 们 首先 从 构 
建 一 个 高 层次 的 流程 开始 ， 它 定义 了 订购 披 陡 的 整体 过 程 。 接 下 来 ， 我 
们 会 将 这 个 流程 拆 分 成 子 流程 ， 这 些 子 流程 在 较 低 的 层次 定义 了 细节 。 


8.3.1 定义 基本 流程 


一 个 新 的 披萨 连锁 店 Spizza 决 定 允 许 用 户 在 线 订 购 以 减轻 店面 电话 的 压 
力 。 当 顾客 访问 Spizza 站 点 时 ， 他 们 需要 进行 用 户 识 别 ， 选 择 一 个 或 更 
多 披 院 添加 到 订单 中 ， 提 供 文 付 信息 然后 提交 订单 并 等 竺 热乎 又 新 鲜 的 
披萨 送 过 来 。 图 8.2 曾 述 了 这 个 流程 。 
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图 8.2 ”将 订购 披萨 的 过 程 归 结 为 一 个 简单 的 流程 


图 中 的 方 框 代表 了 状态 而 箭头 代表 了 转移 。 你 可 以 看 到 ， 订 购 披萨 的 整 
个 流程 很 简单 且 是 线性 的 。 在 Spring Web Flow 中 ， 表 示 这 个 流程 是 很 容 




















en 使 这 个 过 程 变 得 更 有 意思 的 就 是 前 三 个 流程 会 比 图 中 的 简单 方 框 
更 复杂 。 


以 下 的 程序 清单 8.1 展 示 了 如 何 使 用 Spring Web Flow 的 XML 流程 定义 来 
实现 披萨 订单 的 整体 流程 。 


程序 清单 8.1 ”披萨 订单 流程 定义 为 Spring Web Flow 


<?xml version="1.0" encoding="UTF-8"?> 





<flow xmlns="http://Www. Springframewor k, org/schema/webflow" 
xmlns:xsi="http;: //www.w3.org/2001/XMLSchema-~instance" 
xsi:schemaLocation="http://w n mework.org/schema/webf low 
http://www. springframework.org/schema/webflo spring-webflow-2.3.xsd"> 


调用 顾 


<var name="order" 








客 下 ClaSS="”C ain.Order"/> 

流程 <subflow-state ="” ="pizza/customer"> 
<output 7 = ="Oorde her"/> 
<transition on="cus to="*buildorder" /> 


调用 订 
单子 


</subflo 


<Ssubflow tate id="*buildorder" subflow="pizza/order'’> 流程 
<input name="order”" value="order"/> LEE 
ps mw © a 3 调用 支 
<transition on="oOrderCreated" to="takePayment /> i XX 
</subflow-state> 付 子 
<Ssubflow-state QQ= "akePFayrment" subflow="pizza/payment"> 流程 


<input name="order" value="order"/> 


<transition on="paymentTaken" to="saveOrder"/ 


2 S /> r 
</subflow-state> 保存 
<action-state id="saveOrder"> 订单 
<evaluate expr ion="pizzaFlowActions.saveOrder(order})" /> 
<transition to=" nt ankCustomer" / 

</action-state> 

<view-state id="thankCustomer"> 感谢 顾客 
<transition to="endstate" /> 





</Vview-state> 
<end-state id="endstate" /> 
<global-transitions> 
+ neition on="ecancel" to="ends “ fs A jn py i 
<transition on="cancel to="endSstate" /> 全 局 取消 转移 
</global-transitions> 


</flow> 


在 流程 定义 中 ， 我 们 看 到 的 第 一 件 事 就 是 order 变 量 的 声明 。 每 次 流程 
开始 的 时 候 ， 部 会 创建 一 个 Order 实 例 ， order 类 会 带 有 关于 订单 的 所 
有 信息 ， 包 含 顾客 信息 、 订 购 的 披萨 列表 以 及 支付 详情 ， 如 下 面 所 示 。 


程序 清单 8.2 Order 市 有 披 酝 订单 的 所 有 细 市 信息 








package com.springinaction.pizza.domain; 

import java.io.Serializable; 

import java.util.ArrayList; 

import java.util.List; 

public class Order implements Serializable { 
private static final long serialVersionUID = 1L; 


private Customer customer ; 

private List<Pizza> pizzas; 

private Payment payment; 
public Order() { 
pizzas = new ArrayList<Pizza>(); 
customer = new Customer(); 

} 

public Customer getCustomer() { 
return customer; 

} 

public void setCustomer(Customer customer) { 
this.customer = customer; 

} 

public List<Pizza> getPizzas() { 
return pizzas; 


public void setPizzas(List<Pizza> pizzas) { 
this.pizzas = pizzas; 

} 

public void addPizza(Pizza pizza) { 
pizzas.add(pizza); 

} 

public float getTotal() { 
return 6.0f; 

} 

public Payment getPayment() { 
return payment ; 


} 
public void setPayment(Payment payment) { 


this.payment = payment; 
} 





流程 定义 的 主要 组 成 部 分 是 流程 的 状态 。 默 认 情 况 下 ， 流 程 定义 文件 中 
的 第 一 个 状态 也 会 是 流程 访问 中 的 第 一 个 状态 。 在 本 例 中 ， 也 就 
os (一 个 子 流程 》。 但 是 如 果 你 愿意 的 话 ， 你 
可 以 通过 <flow> 元 素 的 start- state 属 性 将 任 意 状 态 指定 为 开始 状 


4UDN Oo 





<?xml version="1.6” encoding="UTF-8"?> 

<flow xmlns="http://www.springframework.org/schema/webflow" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow-2.3.xsd" 
start-state="identifyCustomer"> 


识别 顾客 、 构 造 披萨 订单 以 及 支付 这 样 的 活动 太 复杂 了 ， 并 不 适合 将 其 
强行 塞 入 一 个 状态 。 这 是 我 们 为 何在 后 面 将 其 单独 定义 为 流程 的 原因 。 
但 是 为 了 更 好 地 整体 了 解 披萨 流程 ， 这 些 活动 都 是 以 <subflow- 
state> 元 素来 进行 展现 的 。 


流程 变量 order 将 在 前 三 个 状态 中 进行 填充 并 在 第 四 个 状态 中 进行 保 
存 。identifyCustomer 子 流程 状态 使 用 了 <output> 元 素来 填充 order 
的 customer 属 性 ， 将 其 设置 为 顾客 子 流程 收 到 的 输出 。buildorder 和 
takePayment 状 态 使 用 了 不 同 的 方式 ， 它 们 使 用 <input> 将 order 流 程 
变量 作为 输入 ， 这 些 子 流程 就 能 在 其 内 部 填充 order 对 象 。 


在 订单 得 到 顾客 、 一 些 披 院 以 及 支付 细节 后 ， 就 可 以 对 其 进行 保存 
了 。saveOrder 是 处 理 这 个 任务 的 行为 状态 。 它 使 用 cevaluate> 来 调 
用 ID 为 pizzaFlowActions 的 bean 的 saveOrder() 方 法 ， 并 将 保存 的 订 
单 对 象 传 递 进 来 。 订 单 完 成 保存 后 ， 它 会 转移 到 thankCustomer。 


thankCustomer 状 态 是 一 个 简单 的 视图 状态 ， 后 台 使 用 了 “/WEB- 
INF/flows/pizza/ thankCustomer.jsp” 这 个 JSP 文 件 ， 如 下 所 示 : 


程序 清单 8.3 ”感谢 顾客 订购 的 JSP 视 图 


<html xmlns:jsp="http: 








java.sun.com/JSP/Page"> 
eclarat 


<jsp:output omit-xml-de ion="yes"/> 





在 “感谢 ”页 面 中 ， 会 感谢 顾客 的 订购 并 为 其 提供 一 个 完成 流程 的 链接 。 
I 因为 它 展 示 了 用 户 与 流程 交互 
唯一 办 法 。 


Spring Web Flow 为 视图 的 用 户 提 供 了 一 个 flowExecutionUrl 变 量 ， 它 
包含 了 流程 的 URL。 结 束 链 接 将 一 个 “eventId” 参 数 天 联 到 URL 上 ， 
以 便 回 到 Web 流 程 时 触发 finished 事 件 。 这 个 事件 将 会 让 流程 到 达 结 





束 状态 。 


流程 将 会 在 结束 状态 完成 。 鉴 于 在 流程 结束 后 没有 下 一 步 做 什么 的 具体 
信息 ， 流 程 将 会 重新 从 identifyCustomer 状 态 开始 ， 以 准备 接受 另 一 
个 披萨 订单 。 


这 涵盖 了 订购 披 院 的 整体 流程 。 但 是 这 个 流程 并 不 仪 仪 是 我 们 在 代码 清 
单 8.1 中 所 看 到 的 这 些 。 我 们 还 需要 定 

义 identifyCustomer、buildorder、takePayment 这 些 状态 的 子 流 
程 。 让 我 们 从 识别 用 户 开 始 构建 这 些 流程 。 


8.3.2 ”收集 顾客 信息 


如 果 你 曾经 订购 过 披萨 ， 你 可 能 会 知道 流程 。 他 们 首先 会 询问 你 的 电话 
号 码 。 电 话 号 码 除了 能 够 让 送 货 司 机 在 找 不 到 你 家 的 时 候 打 电 话 给 你 ， 
还 可 以 作为 你 在 这 个 披萨 店 的 标识 。 如 果 你 是 回头 客 ， 他 们 可 以 使 用 这 
个 电话 号 码 来 僵 找 你 的 地 址 ， 这 样 他 们 就 知道 将 你 的 订单 派送 到 什么 地 
pa 


对 于 一 个 新 的 顾客 来 讲 ， 查 询 电话 写 码 不 会 有 什么 结果 。 所 以 接 下 来 ， 
他 们 将 询问 你 的 地 址 。 这 样 ， 披 李 店 的 人 就 会 知道 你 是 谁 以 及 将 披 陕 送 
到 哪里 。 但 是 在 问 你 要 哪 种 披 陡 之 前 ， 他 们 要 确认 你 的 地 址 在 他 们 的 配 
送 范 围 之 内 。 如 宋 不 在 的 话 ， 你 需要 上 自己 到 店 里 并 取 走 披 陕 。 


在 每 个 披 酵 订单 开始 前 的 提问 和 回答 阶段 可 以 用 图 8.3 的 流程 图 来 表 


帮 \。 


这 个 流程 比 整体 的 披萨 流程 更 有 意思 。 这 个 流程 不 是 线性 的 而 是 在 好 几 
个 地 方 根据 不 同 的 条 件 有 了 分 文 。 例 如 ， 在 查找 顾客 后 ， 流 程 可 能 绩 束 
《如 宁 找 到 了 顾客 ) ， 也 有 可 能 转移 到 注册 表单 “如 宁 没 有 找到 顾 
客 ) 。 同 样 ， 在 checkDeliveryArea 状 态 ， 顾 客 有 可 能 会 被 警告 也 有 
可 能 不 被 警告 他 们 的 地 址 在 配送 范围 之 外 。 
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图 8.3 ”识别 顾客 的 流程 比 披萨 流程 有 了 更 多 的 分 支 
以 下 的 程序 清单 展示 了 识别 顾客 的 流程 定义 。 
程序 清单 8.4 使 用 Web 流 程 来 识别 饥饿 的 披萨 顾客 


<?xml version="1.0" encoding="UTF-8"?> 
<flow xmlns="http://www.springframework.org/schema/webflow" 
xmlns:xsi="http://www.w3.0rg/2001/XxMLSchema-~instance" 
xsi:schemaLocation="http://www.springframework.org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow-2.3.xsd"> 
<var name="customer" 
class="com.springinaction.pizza.domain.Customer"/> 
<view-state id="welcome"> < 一 欢迎 顾客 
<transition on="phoneEntered" to="lookupCustomer"/> 
</view-state> 


<action- 
state id="lookupCustomer"> < 一 查找 顾客 
<evaluate result="customer" expression= 
"pizzaFlowActions.lookupCustomer (requestParameters.phoneNumber)" /> 


<transition to="registrationForm'" on-exception= 
"com.springinaction.pizza.service.CustomerNotFoundException" /> 
<transition to="customerReady" /> 
</action-state> 
<view-state id="registrationForm" model="customer"> < 注册 新 顾客 
<on-entry> 
<evaluate expression= 
"customer .phoneNumber = requestParameters.phoneNumber" /> 
</on-entry> 
<transition on="submit" to="checkDeliveryArea" /> 检查 配 
</view-state> 送 区 域 
<decision-state id="checkDeliveryArea"> 
<if test="pizzaFlowActions.checkDeliveryArealcustomer. Zipcodej 
then="addCustomer" 


元 -两 
else="deliveryWarning"/> 显示 配 
</decision-state> 送 警 告 


<view-state id="deliveryWarning"> 
<transition on="accept" to="addCustomer" /> 
</view-state> 添加 顾客 
<action-state id="addCustomer"> < 
<evaluate expression="pizzaFlowActions.addCustomer{customer}" /> 
<transition to="customerReady" /> 
</action-state> 
<end-state id="cancel" /> 
<end-state id="customerReady"> 
<output name="'customer" /> 
</end-state> 
<global-transitions> 
<transition on="cancel" to="cancel" /> 
</global-transitions> 
</flow> 


这 个 流程 包含 了 几 个 新 的 技巧 ， 包 括 我 们 首次 使 用 的 <decision- 
state> 元 素 。 因 为 它 是 pizza 流 程 的 子 流 程 ， 所 以 它 也 可 以 接受 Order 
对 象 作 为 输入 。 


与 前 面 一 样 ， 我 们 还 是 将 这 个 流程 的 定义 分 解 成 一 个 个 的 状态 ， 让 我 们 
从 welcome 状 态 开 始 。 


询问 电话 号 人 码 


welcome 状 态 是 一 个 很 简单 的 视图 状态 ， 它 欢迎 访问 Spizza 站 点 的 顾客 
并 要 求 他 们 输入 电话 号 码 。 这 个 状态 并 没有 什么 特殊 的 。 它 有 两 个 转 


移 : 如 果 从 视图 触发 phoneEntered 事 件 的 话 ， 转 移 会 将 流程 定向 
到 lookupCustomer， 另 外 一 个 就 是 在 全 局 转移 中 定义 的 用 来 啊 应 
cancel 事 件 的 cancel 转 移 。 


welcome 状 态 的 有 趣 之 处 在 于 视图 本 里 。 视 图 welcome 定 义 在 “/WEB- 
INF/flows/ pizza/customer/welcome.jspx” 中 ， 如 下 所 示 。 
程序 清单 8.5 ”欢迎 用 户 并 询问 他 们 的 电话 号 人 码 


<html xmlns:] 


sp="http://java.sun.com/JSP/Page" 





<h2>Welcome to Spizzal!!!</h2> 


<form: form> 





<input type="hidden" name="_f] ey" 
value="${flowExecutionKey}"/> 流程 执 和 J 的 key 
<input type="text" name="phoneNumber"/><br/> 
<input type="submit" name=" eventId phoneEntered" 
value="Lookup Customer" /> 触发 phoneEntered 
</form: form> 事件 
</body> 
‘html> 





这 个 简单 的 表单 提示 用 户 输入 其 电话 号 码 。 但 是 表单 中 有 两 个 特殊 的 部 
分 来 驱动 流程 继续 。 


首先 要 注意 的 是 隐藏 的 “flowExecutionKey” 输 入 域 。 当 进入 视图 状 
态 时 ， 流 程 暂停 并 等 竺 用户 采 取 一 些 行为 。 赋 予 视图 的 流程 执行 
key (flow execution key) 就 是 一 种 返回 流程 的 “回程 票 ”(claim 
ticket) 。 当 用 户 提交 表单 时 ， 流 程 执 行 key 会 
下 


还 要 注意 的 是 提交 按钮 的 名 字 。 按 钮 名 字 的 “_eventId_” 部 分 是 提供 给 
Spring Web Flow 的 一 个 线索 ， 它 表明 了 接 下 来 要 触发 事件 。 当 点 击 这 个 
按钮 提交 表单 时 ， 会 触发 phoneEntered 事 件 进而 转移 

到 lookupCustomer。 


碍 找 顾 客 


当 欢 迎 表 单 提交 后 ， 顾 客 的 电话 号 码 将 包含 在 请 求 参 数 中 并 准备 用 于 碍 
询 顾客 。lookupCustomer 状 态 的 <evaluate> 元 素 是 查找 发 生 的 地 方 。 








它 将 电话 号 码 从 请 求 参 数 中 抽取 出 来 并 传递 到 pizzaFlowActions 
bean 的 lookupCustomer() 方 法 中 。 





目前 ，lookupCustomer() 的 实现 并 不 重要 。 只 需 知道 它 要 么 返回 
Customer 对 象 ， 要 么 抛 出 CustomerNotFoundException 异 常 。 


在 前 一 种 情况 下 ，Customer 对 象 将 会 设置 到 customer 变 量 中 (通过 
result 属 性 ) 并 且 默 认 的 转移 将 把 流程 带 到 customerReady 状 态 。 但 
是 如 果 不 能 找到 顾客 的 话 ， 将 抛 出 CustomerNotFoundException 并 且 
流程 被 转移 到 registrationForm 状 态 。 


注册 新 顾客 


registrationForm 状 态 是 要 求 用 户 填 写 配 送 地 址 的 。 就 像 我 们 之 前 看 
到 的 其 他 视图 状态 ， 它 将 被 演 染 成 JSP。JSP 文 件 如 下 所 示 。 


程序 清单 8.6 注册 新 顾客 





<html xmlns:c="http://java.sun.com/jsp/jst1l/core" 
xmlns:jsp="http://java.sun.com/JSP/Page" 
xmlns:spring="http://www.springframework.org/tags" 
xmlns:form="http://www.springframework.org/tags/form"> 
<jsp:output omit-xml-declaration="yes"/> 
<jsp:directive.page contentType="text/html;charset=UTF-8" /> 
<head><title>Spizza</title></head> 
<body> 
<h2>Customer Registration</h2> 
<form:form commandName="customer"> 
<input type="hidden" name=" flowExecutionKey" 
value="${flowExecutionKey}"/> 
<b>Phone number: </b><form:input path="phoneNumber"/><br/> 
<b>Name: </b><form:input path="name"/><br/> 
<b>Address: </b><form:input path="address"/><br/> 
<b>City: </b><form:input path="city"/><br/> 
<b>State: </b><form:input path="state"/><br/> 
<b>Zip Code: </b><form:input path="zipCode"/><br/> 
<input type="submit" name="_ eventId submit" 
value="Submit" /> 
<input type="submit" name=" eventId cancel" 
value="Cancel" /> 
</form:formy> 
</body> 
</html> 





这 并 非 我 们 在 流程 中 看 到 的 第 一 个 表 早 。welcome 视 图 状态 也 为 顾客 展 
现 了 一 个 表单 ， 那 个 表单 很 简单 ， 并 且 只 有 一 个 输入 域 ， 从 请 求 参数 中 
获得 输入 域 的 值 也 很 简单 。 但 是 注册 表单 就 比较 复杂 了 。 


在 这 里 不 是 通过 请 求 参 数 一 个 个 地 处 理 输入 域 ， 而 是 以 更 好 的 方式 将 表 
单 绑 定 到 Customer 对 象 上 一 一 让 框架 来 做 所 有 繁杂 的 工作 。 


检查 配送 区 域 


在 顾客 提供 其 地 址 后 ， 我 们 需要 确认 他 的 住址 在 配送 范围 之 内 。 如 果 
a 那么 我 们 要 让 顾客 知道 并 建议 他 们 自己 到 店面 
里 取 走 披 院 。 


为 了 做 出 这 个 判断 ， 我 们 使 用 了 决策 状态 。 决 策 状 

态 checkDeliveryArea 有 一 个 <if> 元 素 ， 它 将 顾客 的 邮政 编码 传递 

到 pizzaFlowActions bean 的 checkDeliveryArea() 方 法 中 。 这 个 方 
法 将 会 返回 一 个 Boolean 值 : 如 果 顾 客 在 配送 区 域内 则 为 true， 人 否则 

为 false。 


如 采 顾 客 在 配送 区 域内 的 话 ， 那 流程 转移 到 addCustomer 状 态 。 人 否则 ， 
顾客 被 带 入 到 deliveryWarning 视 网 状态 。deliverywarning 背 后 的 
视 图 就 是 “WEB-INF/flows/pizza/customer/deliveryWarning.jspx”， 如 下 所 
人 外: 


程序 清单 8.7 告知 顾客 不 能 将 披萨 配送 到 他 们 的 地 址 











<html xmlns:jsp="http://java.sun.com/JSP/Page"> 

<jsp:output omit-xml-declaration="yes"/> 

<jsp:directive.page contentType="text/html;charset=UTF-8" /> 

<head><title>Spizza</title></head> 

<body> 
<h2>Delivery Unavailable</h2> 
<p>The address is outside of our delivery area. You may 
still place the order, but you will need to pick it up 
yourself.</p> 
<! [CDATAI[ 
<a href="${flowExecutionUrl}& eventId=accept"> 

Continue，I'11 pick up the order</a> | 

<a href="${flowExecutionUrl}& eventId=cancel">Never mind</ay> 
]]> 

</body> 


</html> 


在 deliveryWarning.jspx 中 与 流程 相关 的 两 个 关键 点 就 是 那 两 个 链接 ， 它 
们 允许 用 户 继续 订单 或 者 将 其 取消 。 通 过 使 用 与 elcome 状态 相同 的 
flowExecurtionUrl 变 量 ， 这 些 链 接 分 别 触 发 流程 中 的 accept 

或 cancel 事 件 。 如 果 发 送 的 是 accept 事 件 ， 那 么 流程 会 转移 

到 addCustomer 状 态 。 否 则 ， 接 下 来 会 是 全 局 的 取消 转移 ， 子 流程 将 会 
转移 到 cance1 结 束 状态 。 


稍 后 我 们 将 介绍 结束 状态 。 让 我 们 先 来 看 看 addCustomer 状 态 。 
存储 顾客 数据 


当 流 程 抵 达 addCustomer 状 态 时 ， 用 户 已 经 输入 了 他 们 的 地 址 。 为 了 将 
来 使 用 ， 这 个 地 址 需要 以 某 种 方式 存储 起 来 (可 能 会 存储 在 数据 库 

中 ) 。addCustomer 状 态 有 一 个 <evaluate> 元 素 ， 它 会 调 

用 pizzaFlowActions bean 的 addCustomer() 方 法 ， 并 将 customer 流 
程 参数 传递 进去 。 


一 旦 这 个 过 程 完成 ， 会 执行 默认 的 转移 ， 流 程 将 会 转移 到 ID 
为 customerReady 的 结束 状态 。 


结束 流程 


一 般 来 讲 ， 沈 程 的 结束 状态 并 不 会 那么 有 意思 。 但 是 这 个 流程 中 ， 它 不 
仅仅 只 有 一 个 结束 状态 ， 而 是 两 个 。 当 子 流程 完成 时 ， 它 会 触发 一 个 与 
结束 状态 有 D 相 同 的 流程 事件 。 如 果 注 程 只 有 一 个 结束 状态 的 话 ， 那 么 它 
始终 会 触发 相同 的 事件 。 但 是 如 果 有 两 个 或 更 多 的 结束 状态 ， 流 程 能 够 
影响 到 调用 状态 的 执行 方向 。 


当 customer 流 程 走 完 所 有 正常 的 路 径 后 ， 它 最 终 会 到 达 ID 

为 customerReady 的 结束 状态 。 当 调用 它 的 披萨 流程 恢复 时 ， 它 会 接收 
到 一 个 customerReady 事 件 ， 这 个 事件 将 使 得 流程 转移 到 buildorder 
状态 。 


要 注意 的 是 customerReady 结 束 状 态 包含 了 一 个 <output> 元 素 。 在 流 
程 中 这 个 元 素 等 同 于 Java 中 的 return 语 句 。 它 从 子 流程 中 传递 一 些 数据 
到 调用 流程 。 在 本 示例 中 ，<output> 元 素 返 回 Customer 流 程 变量 ， 这 














样 在 披萨 流程 中 ， 就 能 够 将 identifyCustomer 子 流程 的 状态 指定 给 订 
单 。 男 一 方面 ， 如 果 在 识别 顾客 流程 的 任意 地 方 触 发 了 cancel 事 件 ， 
将 会 通过 ID 为 cancel 的 结束 状态 退出 流程 ， 这 也 会 在 披萨 流程 中 触发 
cancel 事 件 并 导致 转移 (通过 全 局 转移 ) 到 披萨 流程 的 结束 状态 。 


8.3.3 ”构建 订单 


在 识别 完 顾 客 之 后 ， 主 流程 的 下 一 件 事情 就 是 确定 他 们 想 要 什么 类 型 的 
人 ea 于 提示 用 户 创 建 披 院 并 将 其 放 入 订 时 中 的 ， 如 
8.4 所 不 。 
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图 8.4 通过 订单 子 流程 添加 披萨 
你 可 以 看 到 ，showorder 状 态 位 于 订单 子 流程 的 中 心 位 置 。 这 是 用 户 进 


入 这 个 流程 时 看 到 的 第 一 个 状态 ， 它 也 是 用 户 在 添加 披萨 到 订单 后 要 转 
J 它 展 现 了 订单 的 当前 状态 并 允许 用 户 添加 其 他 的 披萨 到 订 


cancel 








要 添加 披萨 到 订单 时 ， 流 程 会 转移 到 createPizza 状 态 。 这 是 另外 一 个 
视图 状态 ， 人 允许 用 户 选 择 披 陛 的 尺寸 和 面 饼 上 面 的 配料 。 在 这 里 ， 用 户 
可 以 添加 或 取消 披萨 ， 两 种 事件 都 会 使 流程 转移 回 showOrder 状 态 。 


从 showOrder 状 态 ， 用 户 可 能 提交 订单 也 可 能 取消 订单 。 两 种 选择 都 会 
结束 订单 子 流程 ， 但 是 主流 程 会 根据 选择 不 同 进 入 不 同 的 执行 路 径 。 








如 下 显示 了 如 何 将 图 中 所 阐述 的 内 容 转变 成 Spring Web Flow 定 义 。 
程序 清单 8.8 订单 子 流程 的 视图 状态 ， 用 于 展示 订单 和 添加 拔 萨 


?xml] version="1.0" encoding="UTF-8"?> 
flow xmlns="http:/ /www.spri i rk.org/schema/webflow" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 





人 


A 


xsi:schemaLocation="http://www.springframework .org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow-2.3.xsd"> 


<input name="order" required="true" /> 接收 order 作为 输入 
<view-state id="showOrder"> 展现 order 的 状态 
<transition on="createPizza" to="createPizza" /> 


<transition on="checkout" to="orderCreated" /> 
<transition on="cancel" to="cancel" /> 
</view-state> 


<VIew- 
state id="createPizza" model="flowScope.pizza"> 创建 披萨 的 状态 
<on-entry> 
<set name="flowScope.pizza" 
value="new com.springinaction.pizza.domain.Pizza(})" /> 
<evaluate result="viewScope.toppingsbist" expression= 
"T(com,springinaction.pizza.domain.Topping) .asList()" /> 
</on-entry> 
<transition on="addPizza" to="showOrder"> 
<evaluate expression="order.addPizzalflowScope.pizza)" /> 
</transition> 
<transition on="cancel" to="showOrder" /> 
</view-state> 
<end-state id="cancel" / 取消 的 结束 状态 
<end-state id="orderCreated" /> 创建 订单 的 结束 状态 


</flow> 


这 个 子 流程 实际 上 会 操作 主流 程 创建 的 0rder 对 象 。 因 此 ， 我 们 需要 以 
某 种 方式 将 Order 从 主流 程 传 到 子 流程 。 你 可 能 还 记得 在 程序 清单 8.1 中 
我 们 使 用 了 <input> 元 素来 将 Order 传 递 进 流 程 。 在 这 里 ， 我 们 使 用 它 
来 接收 Order 对 象 。 如 果 你 觉得 这 个 流程 与 Java 中 的 方法 有 些 类 似 地 
话 ， 那 这 里 使 用 的 <input> 元 素 实 际 上 束 定 义 了 这 个 子 流程 的 签名 。 这 
个 流程 需要 一 个 名 为 order 的 参数 。 


接 下 来 ， 我 们 会 看 到 showOrder 状 态 ， 它 是 一 个 基本 的 视图 状态 并 具有 
三 个 不 同 的 转移 ， 分 别 用 于 创建 披萨 、 提 交 订 单 以 及 取消 订单 。 


createPizza 状 态 更 有 意思 一 些 。 它 的 视图 是 一 个 表单 ， 这 个 表单 可 以 
添加 新 的 Pizza 对 象 到 订单 中 。<on-entry> 元 素 添 加 了 一 个 新 的 Pizza 
对 象 到 流程 作用 域内 ， 当 表单 提交 时 ， 表 单 的 内 容 会 填充 到 该 对 象 中 。 
需要 注意 的 是 ， 这 个 视图 状态 引用 的 model 是 流程 作用 域内 的 同一 

个 Pizza 对 象 。Pizza 对 象 将 绑 定 到 创建 披萨 的 表单 中 ， 如 下 所 示 。 








程序 清单 8.9 通过 将 流程 作用 域 的 对 象 绑 定 到 HIML 表 单 ， 实 现 添加 
披 陕 到 订单 中 


<div xmlns:form="http://www.springframework.org/tags/form" 
xmlns:jsp="http://java.sun.com/JSP/Page"> 
<jsp:output omit-xml-declaration="yes"/> 
<jsp:directive.page contentType="text/html;charset=UTF-8" /> 
<h2>Create Pizza</h2> 
<form:form commandName="pizza"> 
<input type="hidden" name=" flowExecutionKey" 
value="${flowExecutionKey}"/> 
<b>Size: </b><br/> 
<form:radiobutton path="size" 
label="Small (12-inch)" value="SMALL"/><br/> 
<form:radiobutton path="size" 
label="Medium (14-inch)" value="MEDIUM"/><br/> 
<form:radiobutton path="size" 


label="Large (16-inch)" value="LARGE"/><br/> 
<form:radiobutton path="size" 
label="Ginormous (286-inch)" value="GINORMOUS"/> 


<br/> 
<br/> 
<b>Toppings: </b><br/> 
<form: checkboxes path="toppings" items="${toppingsList}" 
delimiter="&]lt;br/&gt;"/><br/><br/> 
<input type="submit" class="button" 
name=" eventId addPizza” value="Continue"/> 
<input type="submit" class="button" 
name=" eventId cancel" value="Cancel"/> 
</form:form> 
</div> 





当 通 过 Continue 按 钮 提交 订单 时 ， 尺 寸 和 配料 选择 将 会 绑 定 到 Pizza 对 
象 中 并 且 触 发 addPizza 转 移 。 与 这 个 转移 关联 的 <evaluate> 元 素 表 明 
在 转移 到 showOrder 状 态 之 前 ， 流 程 作用 域内 的 Pizza 对 象 将 会 传递 给 
订单 的 addPizza() 方 法 中 。 


有 两 种 方法 来 结束 这 个 流程 。 用 户 可 以 点 击 showOrder 视 图 中 的 Cancel 
按钮 或 者 Checkout 按 钮 。 这 两 种 操作 都 会 使 流程 转移 到 一 个 <end- 
state>。 但 是 选择 的 结束 状态 id 决 定 了 退出 这 个 流程 时 触发 事件 ， 进 
而 最 终 确 定 了 主流 程 的 下 一 步行 为 。 主 流程 要 么 基于 cancel 事 件 要 么 
基于 orderCreated 事 件 进行 状态 转移 。 在 前 者 情况 下 ， 外 边 的 主流 程 
会 结束 ; 在 后 者 情况 下 ， 它 将 转移 到 takePayment 子 流程 ， 这 也 是 接 下 





来 我 们 要 看 的 。 
8.3.4 支付 


吃 免费 披萨 这 事 儿 并 不 常见 。 如 果 Spizza 披 萨 店 让 他 们 的 顾客 不 提供 支 
付 信 息 就 订购 披萨 的 话 ， 估 计 他 们 也 维持 不 了 多 和 久 。 在 披萨 流程 要 结 
ee 的 子 流程 提示 用 户 输入 他 们 的 支付 信息 。 这 个 简单 的 流程 
图 8.5 有 所 不 。 
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图 8.5 ”订购 披 酝 的 最 后 一 步 是 通过 文 付 子 
流程 让 用 户 进 行 支 付 


像 订 单子 流程 一 样 ， 支 付 子 流程 也 使 用 <input> 元 素 接 收 一 个 Order 对 
象 作为 输入 。 


你 可 以 看 到 ， 进 入 文 付 子 流程 的 时 候 ， 用 户 会 到 达 takePayment 状 态 。 
这 是 一 个 视图 状态 ， 在 这 里 用 户 可 以 选择 使 用 信用 卡 、 文 票 或 现金 进行 
支付 。 提 交 支 付 信息 后 ， 将 进入 verifyPayment 状 态 。 这 是 一 个 行为 状 
态 ， 它 将 校 验 文 付 信 息 是 否 可 以 接受 。 


使 用 XML 定 义 的 支付 流程 如 下 所 示 : 
程序 清单 8.10 ”支付 子 流程 有 一 个 视图 状态 和 一 个 行为 状态 





























<?xml version="1.6" encoding="UTF-8"?> 
<flow xmlns="http://www.springframework.org/schema/webflow" 


xmlns:Xsi="http://www.w3.org/2661/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/webflow 
http://www.springframework.org/schema/webflow/spring-webflow-2.3.xsd"> 
<input name="order" required="true"/> 
<view-state id="takePayment" model="flowScope.paymentDetails"> 
<on-entry> 
<set name="flowScope.paymentDetails" 
value="new com.springinaction.pizza.domain.PaymentDetails()" /> 
<evaluate result="viewScope.paymentTypeList" expression= 
"T(com.springinaction.pizza.domain.PaymentType).asList()" /> 
</on-entry> 
<transition on="paymentSubmitted" to="verifyPayment" /> 
<transition on="cancel" to="cancel" /> 
</view-state> 
<action-state id="verifyPayment"> 
<evaluate result="order.payment" expression= 
"pizzaFlowActions.verifyPpayment(flowScope.paymentDetails)" /> 
<transition to="paymentTaken" /> 
</action-state> 
<end-state id="cancel" /> 
<end-state id="paymentTaken" /> 
</flow> 





在 流程 进入 takePayment 视 图 时 ，<on-entry> 元 素 将 构建 一 个 支付 表 
单 并 使 用 SpEL 表 达 式 在 流程 作用 域内 创建 一 个 PaymentDetails 实 例 ， 
这 是 文 撑 表 单 的 对 象 。 它 也 会 创建 视图 作用 域 的 paymentTypeList 变 
量 ， 这 个 变量 是 一 个 列表 包含 了 PaymentType 枚 举 ( 如 程序 清单 8.11 所 
示 ) 的 值 。 在 这 里 ，SpEL 的 T() 操 作用 于 获得 PaymentType 类 ， 这 样 就 
可 以 调用 静态 的 asList() 方 法 。 


程序 清单 8.11 PaymentType 枚 举 定义 了 用 户 可 用 的 支付 选项 





package com.springinaction.pizza.domain; 
import static org.apache.commons.lang.WordUtils.*; 
import java.util.Arrays; 
import java.util.List; 
public enum PaymentType { 
CASH, CHECK, CREDIT CARD; 
public static List<PaymentType> asList() { 
PaymentType[] all = PaymentType.values(); 
return Arrays.asList(all); 
} 
@Override 
public String toSstring() { 
return capitalizeFully(name().replace(' ', " ')); 


在 面 对 支 付 表 单 的 时 候 ， 用 户 可 能 提交 支付 也 可 能 会 取消 。 根 据 做 出 的 
选择 ， 支 付 子 流程 将 以 名 为 paymentTaken 或 cancel 的 <end-state> 结 
束 。 就 像 其 他 的 子 流程 一 样 ， 不 论 哪 种 cend- state> 都 会 结束 子 流 程 并 
但 是 所 采用 <end-state> 的 id 将 决定 主流 程 中 接 下 
来 的 转移 。 


现在 ， 我 们 已 经 依次 介绍 了 披萨 流程 及 其 子 流程 ， 并 看 到 了 Spring Web 
Flow 的 很 多 功能 。 在 我 们 结束 Spring Web Flow 话 题 之 前 ， 让 我 们 快速 了 
解 一 下 如 何 对 流程 及 其 状态 的 访问 增加 安全 保护 。 








8.4 ”保护 Web 流 程 


在 下 一 章 中 ， 我 们 将 会 看 到 如 何 使 用 Spring Security 来 保护 Spring 应 用 程 
序 。 但 现在 我 们 讨论 的 是 Spring Web Flow， 让 我 们 快速 地 看 一 下 Spring 
Web Flow 是 如 何 结合 Spring Security 支 持 流 程 级 别 的 安全 性 的 。 


Spring Web Flow 中 的 状态 、 转 移 甚 至 整个 流程 都 可 以 借助 <secured> 元 
素 实 现 安全 性 ， 该 元 素 会 作为 这 些 元 素 的 子 元 素 。 例 如 ， 为 了 保护 对 一 
个 视图 状态 的 访问 ， 你 可 以 这 样 使 用 <secured>: 











<view-state id="restricted"> 


<secured attributes="ROLE ADMIN" match="all"/> 
</view-state> 





按照 这 里 的 配置 ， 只 有 授予 ROLE_ADMIN 访 问 权 限 (借助 attributes 属 
性 ) 的 用 户 才 能 访问 这 个 视图 状态 。attributes 属 性 使 用 逗号 分 隔 的 
权限 列表 来 表明 用 户 要 访问 指定 状态 、 转 移 或 流程 所 需要 的 权 

限 。match 属 性 可 以 设置 为 any 或 a11。 如 果 设 置 为 any， 那 么 用 户 必须 
至 少 具有 一 个 attributes 属 性 所 列 的 权限 。 如 果 设 置 为 all， 那 么 用 户 
必须 具有 所 有 的 权限 。 你 可 能 想 知 道 用 户 如 何 具备 <secured> 元 素 所 检 
验 的 权限 ， 甚 至 最 开始 的 时 候 用 户 是 如 何 进 行 登录 的 ?这 些 问 题 的 答案 
将 在 第 9 章 给 出 。 











8.5 小结 


并 不 是 所 有 的 Web 应 用 程序 都 是 自由 访问 的 。 有 时 候 ， 必 须 对 用 户 进 行 
指引 、 询 问 适 当 的 问题 并 基于 他 们 的 啊 应 将 其 引导 到 特定 页 面 。 在 这 些 
情况 下 ， 应 用 程序 不 太 像 一 个 荣 单 选项 而 更 像 应 用 程序 与 用 户 之 间 的 对 


话 。 


在 本 章 中 ， 我 们 介绍 了 Spring Web Flow， 它 是 能 够 构建 会 话 式 应 用 程序 
的 Web 框 架 。 在 介绍 的 同时 ， 我 们 构建 了 一 个 基于 流程 的 披萨 订单 应 
和 从 收集 顾客 信息 开始 到 保存 订 
单 到 系统 中 结束 。 


流程 由 多 个 状态 和 转移 组 成 ， 它 们 定义 了 会 话 如 何 从 一 个 状态 到 另 一 个 
状态 。 状 态 本 里 分 为 好 多 种 ， 行为 状态 执行 业务 逻辑 ， 视 图 状态 涉及 到 
流程 中 的 用 户 ， 决 集 状 态 动 态 地 引导 流程 执行 ， 结 束 状态 表明 流程 的 结 
束 ， 除 此 之 外 ， 还 有 子 流程 状态 ， 它 们 自身 是 通过 流程 来 定义 的 。 


最 后 ， 我 们 看 到 如 何 限 制 具有 特定 权限 的 用 户 才 能 访问 流程 、 状 态 或 转 
移 。 但 是 ， 我 们 还 没有 介绍 应 用 程序 对 用 户 的 认证 以 及 如 何 授予 用 户 权 
限 。 这 就 是 Spring Security 能 够 发 挥 作用 的 地 方 了 ， 而 Spring Security 整 
古 我 们 第 9 章 将 要 介绍 的 内 容 。 











第 9 章 ”保护 Web 应 用 


本 章 内 容 : 


。 Spring Security 介 绍 
。 使 用 Servlet 规 范 中 的 Filter 保 护 Web 应 用 
。 基于 数据 库 和 LDAP 进 行 认 证 


有 一 点 不 知道 你 是 否 在 意 过 ， 那 束 是 在 电视 剧 中 大 多 数 人 从 不 锁 门 ?这 
是 司空 见 惯 的 现象 。 在 《Seinfeld》 中 ，Kramer 经 常 到 Jerry 的 房间 里 并 

从 他 的 冰箱 里 拿 东西 吃 。 在 《Friends》 中 ， 很 多 剧 中 的 角色 经 常 不 敲 门 
就 不 假 思索 地 进入 别人 的 房间 。 有 一 次 在 伦敦 ，Ross 甚 衬 问 入 Chandler 
的 旅馆 房间 ， 差 一 点 就 撞见 Chandler 和 Ross 妹妹 的 私 情 。 


在 《Leave it to Beaver》 热 播 的 时 代 ， 人 们 不 锁 门 这 事 儿 并 不 值得 大 尺 
小 怪 。 但 是 在 这 个 隐私 和 安全 被 看 得 极其 重要 的 年 代 ， 看 到 电视 剧 中 的 
角色 人 允许 别人 大 摇 大 捍 地 进入 自己 的 富 所 或 家 中 ， 实 在 让 人 难以 置信 。 


现在 ， 信 息 可 能 是 我 们 最 有 价值 的 东西 ， 一 些 不 怀 好 意 的 人 想 尽 办 法 试 
图 偷偷 进入 不 安全 的 应 用 程序 来 鳃 取 我 们 的 数据 和 号 份 信息 。 作 为 软件 
开发 人 员 ， 我 们 必须 采取 措施 来 保护 应 用 程序 中 的 信息 。 无 论 你 是 通过 
用 户 名 /密码 来 保护 电子 邮件 账号 ， 还 是 基于 交易 PIN 来 保护 经 纪 账 户 ， 
安全 性 都 是 绝 大 多 数 应 用 系统 中 的 一 个 重要 切面 (aspect) 。 


我 有 意 选 择 了 “切面 "这 个 词 来 描述 应 用 系统 的 安全 性 。 安 全 性 是 超越 应 
用 程序 功能 的 一 个 关注 点 。 应 用 系统 的 绝 大 部 分 内 容 都 不 应 该 参与 到 与 
目 己 相关 的 安全 性 处 理 中 。 尽 管 我 们 可 以 直接 在 应 用 程序 中 编写 安全 性 
功能 相关 的 代码 (这 种 情况 并 不 少见 ) ， 但 更 好 的 方式 还 是 将 安全 性 相 
关 的 关注 点 与 应 用 程序 本 映 的 关注 点 进行 分 离 。 


如 果 你 觉得 安全 性 听 上 去 好 像 是 使 用 面 癌 切面 技术 实现 的 ， 那 你 猜 对 
了 。 在 本 章 中 ， 我 们 将 使 用 切面 技术 来 探索 保护 应 用 程序 的 方式 。 不 过 
我 们 不 必 上 自己 开发 这 些 切 面 一 一 我 们 将 介绍 Spring Security， 这 是 一 种 
基于 Spring AOP 和 Servlet 规 范 中 的 Filter 实 现 的 安全 框架 。 





















































9.1 Spring Security 简 介 


Spring Security 是 为 基于 Spring 的 应 用 程序 提供 声明 式 安全 保护 的 安全 性 
框架 。Spring Security 提 供 了 完整 的 安全 性 解决 方案 ， 它 能 够 在 Web 请 求 
级 别 和 方法 调用 级 别处 理 映 份 认 证 和 授权 。 因 为 基于 Spring 框架 ， 所 以 
Spring Security 充 分 利用 了 依赖 注入 《〈dependency injection，DI) 和 面 问 
切面 的 技术 。 


最 初 ，Spring Security 被 称 为 Acegi Security。Acegi 是 一 个 强大 的 安全 框 
架 ， 但 是 它 存 在 一 个 严重 的 问题 : 那 就 是 需要 大 量 的 XML 配置 。 我 不 
会 问 你 介绍 这 种 复杂 配置 的 细节 。 总 之 一 句 话 ， 典 型 的 Acegi 配 置 有 几 
百 行 XML 是 很 常见 的 。 


到 了 2.0 版 本 ，Acegi Security 更 名 为 Spring Security。 但 是 2.0 发 布 版 本 所 
总 来 的 不 仅仅 是 表面 上 名 字 的 变化 。 为 了 在 Spring 中 配置 安全 性 ， 
Spring Security 引 入 了 一 个 全 新 的 、 与 安全 性 相关 的 XML 命名 空间 。 这 
个 新 的 命名 空间 连同 注解 和 一 些 合理 的 默认 设置 ， 将 典型 的 安全 性 配置 
从 几 百 行 XML 减 少 到 十 几 行 。Spring Security 3.0 融 入 了 SpEL， 这 进 一 
步 简化 了 安全 性 的 配置 。 


它 的 最 新 版 本 为 3.2，Spring Security 从 两 个 角度 来 解决 安全 性 问题 。 它 
使 用 Servlet 规 范 中 的 Filter 保 护 Web 请 求 并 限制 UREL 级 别 的 访问 。Spring 
Security 还 能 够 使 用 Spring AOP 保 护 方法 调用 借助 于 对 象 代理 和 使 

用 通知 ， 能 够 确保 只 有 具备 适当 权限 的 用 户 才能 访问 安全 保护 的 方法 。 


在 本 章 中 ， 我 们 将 会 关注 如 何 将 Spring Security 用 于 Web 层 的 安全 性 之 
中 。 在 稍 后 的 第 14 章 中 ， 我 们 会 重新 学 习 Spring Security， 了 解 它 如 何 
保护 方法 的 调用 。 














9.1.1 理解 Spring Security 的 模块 

不 管 你 想 使 用 Spring Security 保 护 哪 种 类 型 的 应 用 程序 ， 第 一 件 需要 做 
的 事 束 是 将 Spring Security 模 块 添加 到 应 用 程序 的 类 路 径 下 。Spring 
Security 3.2 分 为 11 个 模块 ， 如 表 9.1 所 示 。 


表 9.1 ”Spring Security 被 分 成 了 11 个 模块 

















英 块 匣 述 


模 
ACT 支持 通过 访问 控制 列表 (access control list，ACL ) 为 域 对 象 提供 
安全 性 
一 个 很 小 的 模块 ， 当 使 用 Spring Security 注 解 时 ， 会 使 用 基于 
AspectJ 的 切面 ， 而 不 是 使 用 标准 的 Spring AOP 


CAS 客 户 端 提供 与 Jasig 的 中 心 认证 服务 (Central Authentication Service， 
(CAS Client ) CAS) 进行 集成 的 功能 















































配置 本 
《Configuration ) 包含 通过 XML 和 Java 配 置 Spring Security 的 功能 文 持 


核心 (Core) 提供 Spring Security 基 本 库 


加 密 提供 了 加 密 和 密码 编码 的 功能 
Cryptography) 











坟 村 基于 LDAP 进 行 认证 
支持 使 用 OpenID 进 行 集中 式 认证 
提供 了 对 Spring Remoting 的 支持 


标签 库 (Tag 
Library) 








Spring Security 的 JSP 标 签 库 


提供 了 Spring Security 基 于 Filter 的 Web 安 全 性 文 持 








应 用 程序 的 类 路 径 下 至 少 要 包含 Core 和 Configuration 这 两 个 模块 。 
Spring Security 经 常 被 用 于 保护 Web 应 用 ， 这 显然 也 是 Spittr 应 用 的 场 
景 ， 所 以 我 们 还 需要 添加 Web 模 块 。 同 时 我 们 还 会 用 到 Spring Security 的 


JSP 标 签 库 ， 所 以 我 们 需要 将 这 个 模块 也 添加 进来 。 


现在 ， 我 们 已 经 为 在 Spring Security 中 进行 安全 性 配置 做 好 了 准备 。 让 
我 们 看 看 如 何 使 用 Spring Security 的 XML 命名 空间 。 


9.1.2 过滤 Web 请 求 


Spring Security 借 助 一 系列 Servlet Filter 来 提供 各 种 安全 性 功能 。 你 可 能 
会 想 ， 这 是 否 意味 着 我 们 需要 在 web.xml 

或 WebApplicationInitializer 中 配置 多 个 Filter 呢 ?实际 上 ， 借 助 于 
Spring 的 小 技巧 ， 我 们 只 需 配 置 一 个 Filter 就 可 以 了 。 


DelegatingFilterProxy 是 一 个 特殊 的 Servlet Filter， 它 本 里 所 做 的 工 
作 并 不 多 。 只 是 将 工作 委托 给 一 个 javax.servlet.Filter 实 现 类 ， 这 
个 实现 类 作为 一 个 cbean> 注 册 在 Spring 应 用 的 上 下 文中 ， 如 图 9.1 所 
示 。 








DelegatingFilterProxy 已 注入 Spring 的 Filter 





Servlet 上 下 文 Spring 应 用 上 下 文 















































图 9.1 DelegatingFilterProxy 把 Filter 的 处 理 逻 辑 委 托 给 Spring 应 用 
上 下 文中 所 定义 的 一 个 代理 Filter bean 


如 果 你 喜欢 在 传统 的 web.xml 中 配置 Servlet 和 和 Filter 的 话 ， 可 以 使 
用 <filter> 元 素 ， 如 下 所 示 : 























<filter> 
<filter-name>springSecurityFilterChain</filter-name> 
<filter-class> 


org.springframework.web.filter.DelegatingFilterProxy 
</filter-class> 
</filter> 





在 这 里 ， 最 重要 的 是 <filter-name> 设 置 成 了 
springsecurityFilterChain。 这 是 因为 我 们 马上 就 会 将 Spring 
Security 配 置 在 Web 安 全 性 之 中 ， 这 里 会 有 一 个 名 

为 springSecurityFilterChain 的 Filter 
bean，DelegatingFilterProxy 会 将 过 滤 逻 辑 委托 给 它 。 


如 果 你 希望 借助 NebApplicationInitializer 以 Java 的 方式 来 配 
置 Delegating-FilterProxy 的 话 ， 那 么 我 们 所 需要 做 的 就 是 创建 一 个 
扩展 的 新 类 : 


package spitter.config; 
import org.springframework.security .web.context. 


AbstractSecuritywWebApplicationInitializer; 
public class SecurityWebInitializer 
extends AbstractSecurityWebApplicationInitializer {} 





AbstractSecurityWebApplicationInitializer 实 现 了 
WebApplication-Initializer， 因 此 Spring 会 发 现 它 ， 并 用 它 在 Web 
容器 中 注册 DelegatingFilterProxy。 尽 管 我 们 可 以 重 载 它 的 
appendFilters() 或 insertFilters() 方 法 来 注册 自己 选择 的 Filter， 
和 我 们 并 不 需要 重 载 任何 方 
ye 


不 管 我 们 通过 web.xml 还 是 通过 
AbstractSecurityWebApplicationInitializer 的 子 类 来 配 

置 DelegatingFilterProxy， 它 都 会 拦截 发 往 应 用 中 的 请 求 ， 并 将 请 
求 委托 给 ID 为 springSecurityFilterChain bean。 


springSecurityFilterChain 本 身 是 另 一 个 特殊 的 Filter， 它 也 被 称 
为 FilterChainProxy。 它 可 以 链接 任意 一 个 或 多 个 其 他 的 Filter。 
Spring Security 依 赖 一 系列 Servlet Filter 来 提供 不 同 的 安全 特性 。 但 是 ， 
你 几乎 不 需要 知道 这 些 细节 ， 因 为 你 不 需要 显 式 声 

明 springSsecurityFilterChain 以 及 它 所 链接 在 一 起 的 其 他 Filter。 当 
我 们 启用 Web 安 全 性 的 时 候 ， 会 自动 创建 这 些 Filter。 


为 了 让 Web 安 全 性 运行 起 来 ， 我 们 创建 一 个 最 简单 的 安全 性 配置 。 

9.1.3 ”编写 简单 的 安全 性 配置 

在 Spring Security 的 早期 版 本 中 在 其 还 被 称 为 Acegi Security 之 时 ) ， 

为 了 在 Web 应 用 中 局 用 简单 的 安全 功能 ， 我 们 需要 编写 上 百 行 的 XML 配 


置 。Spring Security 2.0 提 供 了 安全 性 相关 的 XML 配置 命名 空间 ， 让 情况 
有 了 一 些 好转。 





Spring 3.2 引 入 了 新 的 Java 配 置 方案 ， 完 全 不 再 需要 通过 XML 来 配置 安全 
性 功能 了 。 如 下 的 程序 清单 展现 了 Spring Security 最 简单 的 Java 配 置 。 


程序 清单 9.1 局 用 Web 安 全 性 功能 的 最 简单 配置 





顾名思义 ，@EnableWebSecurity 注 解 将 会 启用 Web 安 全 功能 。 但 它 本 
身 并 没有 什么 用 处 ，Spring Security 必 须 配置 在 一 个 实现 了 
WebSecurityConfigurer 的 bean 中 ， 或 者 (简单 起 见 ) 扩 

展 WebsecurityConfigurerAdapter。 在 Spring 应 用 上 下 文中 ， 任 何 实 
现 了 WebsecurityConfigurer 的 bean 都 可 以 用 来 配置 Spring Security， 
但 是 最 为 简单 的 方式 还 是 像 程 序 清单 9.1 那 样 扩 

展 WebSecurityConfigurer Adapter 类 。 


@EnableWebSecurity 可 以 启用 任意 Web 应 用 的 安全 性 功能 ， 不 过 ， 如 
果 你 的 应 用 碰巧 是 使 用 Spring MVC 开 发 的 ， 那 么 就 应 该 考虑 使 
用 @EnableWebMvcSecurity 奉 代 它 ， 如 程序 清单 9.2 所 示 。 


程序 清单 9.2 为 Spring MVC 启 用 Web 安 全 性 功能 的 最 简单 配置 


启用 
Spring 
MVC 
安全 性 





除了 其 他 的 内 容 以 外 ，@EnableWebMvcSecurity 注 解 还 配置 了 一 个 

Spring MVC 参 数 解 析 解 析 器 (argument resolver) ， 这 样 的 话 处 理 器 方 
法 就 能 够 通过 带 有 @AuthenticationPrincipal 注 解 的 参数 获得 认证 用 
户 的 principal (或 username) 。 它 同时 还 配置 了 一 个 bean， 在 使 用 Spring 
表单 绑 定 标签 库 来 定义 表单 时 ， 这 个 bean 会 自动 添加 一 个 隐藏 的 跨 站 请 








求 伪 造 (cross-site request forgery，CSRF) token 输 入 域 。 


看 起 来 似乎 并 没有 做 太 多 的 事情 ， 但 程序 清单 9.1 和 9.2 中 的 配置 类 会 给 
应 用 产生 很 大 的 影响 。 其 中 任何 一 种 配置 都 会 将 应 用 严格 锁定 ， 导 致 没 
有 人 外 # 够 进入 该 系统 了 1 


尽管 不 是 严格 要 求 的 ， 但 我 们 可 能 希望 指定 Web 安 全 的 细节 ， 这 要 通过 
重 载 WNebsecurityConfigurerAdapter 中 的 一 个 或 多 个 方法 来 实现 。 
我 们 可 以 通过 重 载 NebSecurityConfigurerAdapter 的 三 

个 configure() 方 法 来 配置 Web 安 全 性 ， 这 个 过 程 中 会 使 用 传递 进来 的 
参数 设置 行为 。 表 9.2 描 述 了 这 三 个 方法 。 








表 9.2 重 载 WebSecurityConfigurerAdapter 的 configure() 方 法 


configure(WebSecurity) 通过 重 帮 



































让 我 们 重新 看 一 下 程序 清单 9.2， 可 以 看 到 它 没 有 重 写 上 述 三 

个 configure() 方 法 中 的 任何 一 个 ， 这 就 说 明了 为 什么 应 用 现在 是 被 锁 
定 的 。 尽 管 对 于 我 们 的 需求 来 讲 默认 的 Filter 链 是 不 错 的 ， 但 是 默认 的 
configure(HttpSecurity) 实 际 上 等 同 于 如 下 所 示 : 























protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 
.anyRequest().authenticated() 


.and() 
.formLogin().and() 
.httpBasic(); 





文 个 简单 的 默认 配置 指定 了 该 如 何 保 护 HITTP 请 求 ， 以 及 客户 端 认 证 用 


户 的 方案 。 通 过 调用 authorizeRequests() 和 

anyRequest() .authenticated() 就 会 要 求 所 有 进入 应 用 的 HITP 请 求 
都 要 进行 认证 。 它 也 配置 Spring Security 支 持 基 于 表单 的 登录 以 及 HTTP 
Basic 方 式 的 认证 。 

同时 ， 因 为 我 们 没有 重 

载 configure(AuthenticationManagerBuilder) 方 法 ， 所 以 没有 用 
户 存 储 文 撑 认证 过 程 。 没 有 用 户 存 储 ， 实 际 上 就 等 于 没有 用 户 。 所 以 ， 
在 这 里 所 有 的 请 求 都 需要 认证 ， 但 是 没有 人 能 够 登录 成 功 。 


为 了 让 Spring Security 满 足 我 们 应 用 的 需求 ， 还 需要 再 添加 一 点 配置 。 
具体 来 讲 ， 我 们 需要 : 


。 配置 用 户 存 储 ; 
。 指定 哪些 请 求 需要 认证 ， 哪 些 请 求 不 需要 认证 ， 以 及 所 需要 的 权 


限 ; 
。 提供 一 个 自 定 义 的 登录 页 面 ， 蔡 代 原 来 简单 的 默认 登录 页 。 


除了 Spring Security 的 这 些 功能 ， 我 们 可 能 还 希望 基于 安全 限制 ， 有 选 
择 性 地 在 Web 视 图 上 显示 特定 的 内 容 。 


但 首先 ， 我 们 看 一 下 如 何在 认证 的 过 程 中 配置 访问 用 户 数 据 的 服务 。 











9.2 选择 得 询 用 户 详细 信息 的 服务 


假如 你 计划 去 一 个 独家 经 营 的 饭店 享受 一 顿 晚 餐 ， 当 然 ， 你 会 提前 几 周 
预订 ， 保 证 到 时 候 能 有 一 个 位 置 。 当 a 到达 饭 店 的 时 候 ， 你 会 告诉 服务 员 
你 的 名 字 。 但 令 人 遗憾 的 是 ， 里 面 并 没有 你 的 预订 记录 。 美 好 的 夜晚 眼 
看 就 要 泡汤 了 。 但 是 没有 人 会 如 此 轻易 地 放弃 ， 你 会 要 求 服务 员 再 次 确 
认 预 订 名 单 。 此 时 ， 事 情 变 得 有 些 怪异 


服务 员 说 没有 预订 名 单 。 你 的 名 字 不 在 名 单 上 一 一 名 单 上 没有 任何 人 

一 一 因为 根本 就 不 存在 这 么 个 名 单 。 这 就 解释 了 为 什么 位 置 是 空 的 ， 但 
我 们 却 进 不 去 。 几 周 后 ， 我 们 也 就 明日 这 家 饭店 为 何 最 终 会 天 门 大 吉 ， 

被 一 家 墨西哥 美食 店 所 代 葡 。 


这 也 是 此 时 我 们 应 用 程序 的 现状 。 我 们 没有 办 法 进入 应 用 ， 即 便 用 户 认 
为 他 们 应 该 能 够 登录 进去 ， 但 实际 上 却 没 有 允许 他 们 访问 应 用 的 数据 记 
录 。 因 为 缺少 用 户 存 储 ， 现 在 的 应 用 程序 太 封 闭 了 ， 变 得 不 可 用 。 


我 们 所 需要 的 是 用 户 存 储 ， 也 就 是 用 户 名 、 密 码 以 及 其 他 信息 存储 的 地 
方 ， 在 进行 认证 决策 的 时 候 ， 会 对 其 进行 检索 。 


好 消息 是 ，Spring Security 非 常 灵 活 ， 能 够 基于 各 种 数据 存储 来 认证 用 
户 。 它 内 置 了 多 种 常见 的 用 户 存 储 场景 ， 如 内 存 、 关 系 型 数据 库 以 及 
LDAP。 但 我 们 也 可 以 编写 并 插入 自 定义 的 用 户 存 储 实现 。 


借助 Spring Security 的 Java 配 置 ， 我 们 能 够 很 容易 地 配置 一 个 或 多 个 数据 
存储 方案 。 那 我 们 就 从 最 简单 的 开始 : 在 内 存 中 维护 用 户 存储 。 


9.2.1 使 用 基于 内 存 的 用 户 存储 


因为 我 们 的 安全 配置 类 扩展 了 WebsecurityConfigurerAdapter， 
此 配置 用 户 存 储 的 最 简单 方式 就 是 重 载 configure() 方 法 ， 并 以 
AuthenticationManagerBuilder 作 为 传 入 参 

数 。AuthenticationManagerBuilder 有 多 个 方法 可 以 用 来 配置 Spring 
Security 对 认证 的 支持 。 通 过 inMemoryAuthentication() 方 法 ， 我 们 
可 以 启用 、 配 置 并 任意 填充 基于 内 存 的 用 户 存 储 。 
































例如 ， 在 如 程序 清单 9.3 中 ，SsecurityConfig 重 载 了 configure() 方 
法 ， 并 使 用 两 个 用 户 来 配置 内 存 用 户 存 储 。 


程序 清单 9.3 配置 Spring Security 使 用 内 存 用 户 存储 





启用 
内 存 
用 户 
存储 





我 们 可 以 看 到 ，configure() 方 法 中 的 
AuthenticationManagerBuilder 使 用 构造 者 风格 的 接口 来 构建 认证 
配置 。 通 过 简单 地 调用 inMemoryAuthentication() 就 能 启用 内 存 用 户 
人 否则 的 话 ， 这 和 没有 用 户 并 没有 什 
么 区 列 。 


因此 ， 我 们 需要 调用 withUser() 方 法 为 内 存 用 户 存储 添加 新 的 用 户 ， 
这 个 方法 的 参数 是 username。withUser() 方 法 返回 的 

是 UserDetailsManagerConfigurer.UserDetailsBuilder， 这 个 对 
象 提供 了 多 个 进一步 配置 用 户 的 方法 ， 包 括 设 置 用 户 密码 的 
password() 方 法 以 及 为 给 定 用 户 授予 一 个 或 多 个 角色 权限 的 roles() 
27 

在 程序 清单 9.3 中 ， 我 们 添加 了 两 个 用 户 ，“user* 和 “admin”， 密 码 均 
为 “password”。 “user” 用 户 具 有 USER 角 色 ， 而 “admin” 用 户 具有 ADMIN 
I 。 我 们 可 以 看 到 ，and() 方 法 能 够 将 多 个 用 户 的 配置 连 
关 所 来。 








除了 password()、roles() 和 and() 方 法 以 外 ， 还 有 其 他 的 几 个 方法 可 
以 用 来 配置 内 存 用 户 存储 中 的 用 户 信 息 。 表 9.3 描 述 了 
UserDetailsManagerConfigurer.UserDetailsBuilder 对 象 所 有 可 
用 的 方法 。 


需要 注意 的 是 ，roles() 方 法 是 authorities() 方 法 的 简写 形 
式 。roles() 方 法 所 给 定 的 值 都 会 添加 一 个 “ROLE_” 前 级 ， 并 将 其 作为 
权限 授予 给 用 户 。 实 际 上 ， 如 下 的 用 户 配置 与 程序 清单 9.3 是 等 价 的 : 





auth 
.inMemoryAuthentication() 
.withUser("user").password("password") 


.authorities("ROLE USER").and() 
.withUser("admin").password("password") 
.authorities("ROLE USER", "ROLE ADMIN"); 





表 9.3 ”配置 用 户 详 细 信 息 的 方法 
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disabled(boolean) 定义 账号 是 否 己 被 禁用 





password(String) 定义 用 户 的 密码 
一 项 或 多 项 





roles(String...) 授予 某 个 用 户 项 或 多 项 角色 


对 于 调试 和 开 及 人 员 测 试 来 讲 ， 基 于 内 存 的 用 户 存 储 是 很 有 用 的 ， 但 是 
对 于 生产 级 别 的 应 用 来 讲 ， 这 就 不 是 最 理想 的 可 选 方 有 末了。 为 了 用 于 生 
产 坏 境 ， 通 第 最 好 将 用 户 数 据 保存 在 东 种 类 型 的 数据 库 之 中 。 


9.2.2 基于 数据 库 表 进 行 认证 
用 户 数 据 通 常会 存储 在 关系 型 数据 库 中 ， 并 通过 JDBC 进 行 访问 。 为 了 


配置 Spring Security 使 用 以 JDBC 为 文 撑 的 用 户 存储 ， 我 们 可 以 使 
用 jdbcAuthentication() 方 法 ， 所 需 的 最 少 配置 如 下 所 未 : 














@Autowired 
DataSource dataSource; 


@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 
auth 
.jdbcAuthentication() 
.dataSource(dataSource); 





我 们 必须 要 配置 的 只 是 一 个 Datasource， 这 样 的 话 ， 就 能 访问 关系 型 
数据 库 了 。 在 这 里 ，DataSource 是 通过 自动 装配 的 技巧 得 到 的 。 


重 写 默认 的 用 户 碍 询 功 能 


尽管 默认 的 最 少 配置 能 够 让 一 切 运转 起 来 ， 但 是 它 对 我 们 的 数据 库 模 式 
有 一 些 要 求 。 它 预期 存在 某 些 存储 用 户 数据 的 表 。 更 具体 来 说 ， 下 面 的 
代码 片段 来 源 于 Spring Security 内 部 ， 这 块 代码 展现 了 当 查 找 用 户 信 息 
时 所 执行 的 SQL 查 询 语句 : 











public static final String DEF_USERS_ BY_USERNAME QUERY = 
"select username,password,enabled ”+ 


"from users ”十 
"where username = ?"; 
public static final String DEF _ AUTHORITIES_ BY _ USERNAME QUERY = 
"select username,authority " + 
"from authorities " + 
"where username = ?"; 
public static final String DEF_ GROUP AUTHORITIES BY USERNAME QUERY = 
"select g.id, g.group name, ga.authority " + 
"from groups g, group_ members gm, group authorities ga "+ 
"where gm.username = ? "+ 
"and g.id = ga.group _ id ”+ 
"and g.id = gm.group_id"; 





在 第 一 个 查询 中 ， 我 们 获取 了 用 户 的 用 户 名 、 蜜 码 以 及 是 否 局 用 的 信 
息 ， 这 些 信息 会 用 来 进行 用 户 认证 。 接 下 来 的 查询 查找 了 用 户 所 授予 的 
i A 
受 予 的 权限 。 


如 果 你 能 够 在 数据 库 中 定义 和 填充 满足 这 些 查 询 的 表 ， 那 么 基本 上 惑 不 
需要 你 再 做 什么 额外 的 事情 了 。 但 是 ， 也 有 可 能 你 的 数据 库 与 上 面 所 述 
并 不 一 致 ， 那 么 你 就 会 希望 在 查询 上 有 更 多 的 控制 权 。 如 采 是 这 样 的 
话 ， 我 们 可 以 按照 如 下 的 方式 配置 自己 的 碍 询 : 








@Override 
protected void configure(AuthenticationManagerBuilder auth) 


throws Exception { 
auth 


.jdbcAuthentication() 
.dataSource(dataSource) 


.UsersByUsernameQuery( 
"Select username, password, true " + 
"from Spitter where username=?") 
.authoritiesByUsernameQuery( 
"select username, 'ROLE USER' from Spitter where username=?"); 











在 本 例 中 ， 我 们 只 重 写 了 认证 和 基本 权限 的 查询 语句 ， 但 是 通过 调 
用 group-AuthoritiesByUsername() 方 法 ， 我 们 也 能 够 将 群 组 权限 重 
写 为 自 定义 的 查询 语句 。 


将 默认 的 SQL 便 询 蔡 换 为 自 定 义 的 设计 时 ， 很 重要 的 一 点 就 是 要 杂 循 伍 
询 的 基本 协议 。 所 有 查询 都 将 用 户 名 作为 唯一 的 参数 。 认 证 查询 会 选取 

















用 户 名 、 蜜 码 以 及 局 用 状态 信息 。 权 限 查 询 会 选取 零 行 或 多 行 包 含 该 用 
户 名 及 其 权限 信息 的 数据 。 群 组 权限 查询 会 选取 零 行 或 多 行 数据 ， 每 行 
数据 中 都 会 包含 群 组 ID、 群 组 名 称 以 及 权限 。 


使 用 转 码 后 的 密码 


看 一 下 上 面 的 认证 碍 询 ， 筷 会 预期 用 户 密码 存储 在 了 数据 库 之 中 。 这 里 
唯一 的 问题 在 于 如 果 密 码 明 文 存储 的 话 ， 会 很 容易 受到 黑客 的 贸 取 。 但 
和 是， 如 条 数据 库 中 的 密码 进行 了 转 码 的 话 ， 那 么 认证 就 会 失败 ， 因 为 它 
与 用 户 提 区 的 明文 密码 并 不 匹配 。 


为 了 解决 这 个 问题 ， 我 们 需要 借助 passwordEncoder() 方 法 指定 一 个 
密码 转 码 器 (encoder) : 




















@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.jdbcAuthentication() 
.dataSource(dataSource) 


.UsersByUsernameQuery( 

"Select username, password, true " + 

"from Spitter where username=?") 
.authoritiesByUsernameQuery( 

"select username, 'ROLE USER' from Spitter where username=?") 
.passwordEncoder(new StandardPasswordEncoder("53cr3t")); 





passwordEncoder() 方 法 可 以 接受 Spring Security 中 PasswordEncoder 
接口 的 任意 实现 。Spring Security 的 加 密 模 块 包括 了 三 个 这 样 的 实 

现 : BCryptPasswordEncoder、NoopPasswordEncoder 和 
StandardPasswordEncoder。 


上 述 的 代码 中 使 用 了 StandardPasswordEncoder， 但 是 如 果 内 置 的 实 
现 无 法 满足 需求 时 ， 你 可 以 提供 目 定 义 的 实现 。PasswordEncoder 接 
口 非 常 简 单 : 


public interface PasswordEncoder { 
String encode(CharSequence rawPassword ) ; 


boolean matches(CharSequence rawpPassword，Sstring encodedPassword ) ; 


} 





不 管 你 使 用 哪 一 个 密码 转 码 器 ， 痢 需要 理解 的 一 点 是 ， 数 据 库 中 的 密码 
是 永远 不 会 解码 的 。 所 采取 的 策略 与 之 相反 ， 用 户 在 登录 时 输入 的 密码 
会 按照 相同 的 算法 进行 转 码 ， 然 后 再 与 数据 库 中 己 经 转 码 过 的 密码 进行 
对 比 。 这 个 对 比 是 在 PasswordEncoder 的 matches() 方 法 中 进行 的 。 





9.2.3 ”基于 LDAP 进 行 认 证 


为 了 让 Spring Security 使 用 基于 LDAP 的 认证 ， 我 们 可 以 使 

用 1dapAuthentication() 方 法 。 这 个 方法 在 功能 上 类 似 于 
jdbcAuthentication()， 只 不 过 是 LDAP 版 本 。 如 下 的 configure() 
方法 展现 了 LDAP 认 证 的 简单 配置 : 


@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.ldapAuthentication() 
.UserSearchFilter("(uid={06})") 
.EroupSearchFilter("member={06}"); 





方法 userSearchFilter() 和 groupSearchFilter() 用 来 为 基础 LDAP 
查询 提供 过 滤 条 件 ， 它 们 分 别 用 于 搜索 用 户 和 组 。 默 认 情 况 下 ， 对 于 用 
户 和 组 的 基础 得 询 都 是 空 的 ， 也 就 是 表明 搜索 会 在 LDAP 层 级 结构 的 根 
开始 。 但 是 我 们 可 以 通过 指定 查询 基础 来 改变 这 个 默认 行为 : 











@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 
auth 
.ldapAuthentication() 


.UserSearchBase("ou=people") 
.UserSearchFilter("(uid={06})") 
.EroupSearchBase("ou=groups") 
.groupSearchFilter("member={06}"); 





userSearchBase() 属 性 为 查找 用 户 提 供 了 基础 查询 。 同 

样 ，groupsearchBase() 为 查找 组 指定 了 基础 得 询 。 我 们 声明 用 户 应 
该 在 名 为 people 的 组 织 单元 下 搜索 而 不 是 从 根 开 始 。 而 组 应 该 在 名 
为 groups 的 组 织 单元 下 搜索 。 











配置 密码 比 对 


基 填 LDAP 进 行 认证 的 扶 认 大 略 是 进行 绑 定 操作 ， 直 接 通 过 LDAP 服 务 
器 认证 用 户 。 男 一 种 可 选 的 方式 是 进行 比 对 操作 。 这 涉及 将 输入 的 密码 
发 送 到 LDAP 目 录 上 ， 并 要 求 服 务 器 将 这 个 密码 和 用 户 的 密码 进行 比 
对 。 因 为 比 对 是 在 LDAP 服 务 器 内 完成 的 ， 实 际 的 密码 能 保持 私密 。 


如 果 你 希望 通过 密码 比 对 进行 认证 ， 可 以 通 
明 passwordCompare() 方 法 来 实现 : 








@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.ldapAuthentication() 


.UserSearchBase("ou=people") 
.UserSearchFilter("(uid={06})") 
.EroupSearchBase("ou=groups") 
.groupSearchFilter("member={06}") 
.passwordCompare() ; 





默认 情况 下 ， 在 登录 表单 中 提供 的 密码 将 会 与 用 户 的 LDAP 条 目 中 的 
userPassword 属 性 进行 比 对 。 如 果 密 码 被 保存 在 不 同 的 属性 中 ， 可 以 
通过 passwordAttribute( ) 方 法 来 声明 密码 属性 的 名 称 : 





@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 
auth 
.ldapAuthentication() 
.UserSearchBase("ou=people") 
.UserSearchFilter("(uid={06})") 


.groupSearchBase("ou=groups") 
.groupSearchFilter("member={06}") 
.passwordCompare() 

.passwordEncoder(new Md5PasswordEncoder()) 
.passwordAttribute("passcode"); 











在 本 例 中 ， 我 们 指定 了 要 与 给 定 密码 进行 比 对 的 是 “passcode” 属 性 。 
另外 ， 我 们 还 可 以 指定 密码 转 码 器 。 在 进行 服务 器 端 密码 比 对 时 ， 有 一 





点 非常 好 ， 那 就 是 实际 的 密码 在 服务 器 端 是 私密 的 。 但 是 进行 尝试 的 密 
码 还 是 需要 通过 线路 传输 到 LDAP 服 务 器 上 ， 这 可 能 会 被 黑客 所 拦截 。 
为 了 避免 这 一 点 ， 我 们 可 以 通过 调用 passwordEncoder() 方 法 指定 加 


在 本 示例 中 ， 密 码 会 进行 MD5 加 密 。 这 需要 LDAP 服 务 器 上 密码 也 使 用 
MD5 进 行 加 密 。 
引用 远程 的 LDAP 服 务 器 


到 目前 为 止 ， 我 们 忽略 的 一 件 事 束 是 LDAP 和 实际 的 数据 在 哪里 。 我 们 
很 开心 地 配置 Spring 使 用 LDAP 服 务 器 进行 认证 ， 但 是 服务 器 在 哪里 
呢 ? 


默认 情况 下 ，Spring Security 的 LDAP 认 证 假设 LDAP 服 务 器 监听 本 机 的 
33389 端 口 。 但 是 ， 如 果 你 的 LDAP 服 务 器 在 另 一 台 机 器 上 ， 那 么 可 以 使 
用 contextSource() 方 法 来 配置 这 个 地 址 : 





@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 
auth 
.ldapAuthentication() 
.UsSerSearchBase("ou=people") 


.UserSearchFilter("(uid={6})") 

.groupSearchBase("ou=groups") 

.groupSearchFilter("member={06}") 

.ContextSource() 
.Url("ldap://habuma.com:389/dc=habuma,dc=com"); 





contextSource() 方 法 会 返回 一 个 ContextSourceBuilder 对 象 ， 这 
个 对 象 除 了 其 他 功能 以 外 ， 还 提供 了 url() 方 法 用 来 指定 LDAP 服 务 器 
的 地 址 。 


配置 嵌入 式 的 LDAP 服 务 器 
如 果 你 没有 现成 的 LDAP 服 务 器 供认 证 使 用 ，Spring Security 还 为 我 们 提 


供 了 磐 入 式 的 LDAP 服 务 器 。 我 们 不 再 需要 设置 远程 LDAP 服 务 融 的 
URL， 只 需 通 过 root( ) 方 法 指定 舱 入 式 服务 占 的 根 前 级 束 可 以 了 : 


@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.ldapAuthentication() 
.UsSerSearchBase("ou=people") 


.UserSearchFilter("(uid={06})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter("member={06}") 
.ContextSource() 
.root("dc=habuma,dc=com" ); 





当 LDAP 服 务 器 启动 时 ， 它 会 尝试 在 类 路 径 下 寻找 LDIF 文 件 来 加 载 数 
据 。LDIF (LDAP Data Interchange Format，LDAP 数 据 交 换 格 式 ) 是 以 
文本 文件 展现 LDAP 数 据 的 标准 方式 。 每 条 记录 可 以 有 一 行 或 多 行 ， 
项 包含 一 个 名 值 对 。 记 录 之 间 通 过 空 行进 行 分 割 。 


如 果 你 不 想 让 Spring 从 整个 根 路 径 下 搜索 LDIE 文 件 的 话 ， 那 么 可 以 通过 
调用 1dif() 方 法 来 明确 指定 加 载 哪个 LDIE 文 件 : 











@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 
auth 
.ldapAuthentication() 
.UsSerSearchBase("ou=people") 
.UserSearchFilter("(uid={6})") 
.groupSearchBase("ou=groups") 
.groupSearchFilter("member={06}") 
.CcontextSource() 
.root("dc=habuma,dc=com") 
.ldif("classpath:users.1dif"); 





在 这 里 ， 我 们 明确 要 求 LDAP 服 务 器 从 类 路 径 根 目录 下 的 users.ldif 文 件 
中 加 载 内 容 。 如 果 你 比较 好 奇 的 话 ， 如 下 惑 是 一 个 包含 用 户 数据 LDIF 
文件 ， 我 们 可 以 使 用 它 来 加 载 骨 入 式 LDAP 服 务 器 : 





dn: ou=groups,dc=habuma,dc=com 
objectclass: top 

objectclass: organizationalUnit 
ou: groups 


dn: ou=people,dc=habuma, dc=com 
objectclass: top 

objectclass: organizationalUnit 

ou: people 

dn: uid=habuma,ou=people,dc=habuma,dc=com 
objectclass: top 

objectclass: person 

objectclass: organizationalPerson 
objectclass: inetOrgPerson 

cn: Craig Walls 

sn: Walls 

uid: habuma 

userPassword: password 

dn: uid=jsmith,ou=people,dc=habuma,dc=com 
objectclass: top 

objectclass: person 

objectclass: organizationalPerson 
objectclass: inetOrgPerson 

cn: John Smith 

sn: Smith 

uid: jsmith 

userPassword: password 

dn: cn=spittr,ou=groups,dc=habuma,dc=com 
objectclass: top 

objectclass: groupOfNames 

cn: spittr 

member: uid=habuma,ou=people,dc=habuma,dc=com 











Spring Security 内 置 的 用 户 存 储 非常 便利 ， 并 且 涵 盖 了 最 为 常用 的 用 户 
场景 。 但 是 ， 如 果 你 的 认证 需求 不 是 那么 通用 的 话 ， 那 么 就 需要 创建 并 
配置 自 定义 的 用 户 详 细 信 息 服 务 了 。 


9.2.4 ”配置 自 定 义 的 用 户 服务 
假设 我 们 需要 认证 的 用 户 存 储 在 非 关 系 型 数据 库 中 ， 如 Mongo 或 


Neo4j， 在 这 种 情况 下， 我 们 需要 提供 一 个 自 定义 的 
UserDetailsService 接 口 实现 。 





UserDetailsService 接 口 非常 简单 : 





public interface UserDetailsService { 
UserDetails loadUserByUsername(String username) 
throws UsernameNotFoundException; 





我 们 所 需要 做 的 就 是 实现 lo0adUserByUsername() 方 法 ， 根 据 给 定 的 用 
户 名 来 查找 用 户 。loadUserByUsername( ) 方 法 会 返回 代表 给 定 用 户 的 
UserDetails 对 象 。 如 下 的 程序 清单 展现 了 一 个 UserDetailsService 
的 实现 ， 它 会 从 给 定 的 SpitterRepository 实 现 中 查找 用 户 。 


程序 清单 9.4 从 SpitterRepository 中 查找 UserDetails 对 象 


package spittr.security; 
import org.springframework.security.core.GrantedAuthority; 
import org.springframework.security.core.authority. 
SimpleGrantedAuthority; 
import org.springframework.security.core.userdetails.User; 
import org.springframework.security.core.userdetails,.UserDetails; 
import org.springframework.security.core.userdetails. 
UserDetailsService; 
import org.springframework.security.core.userdetails. 
UsernameNotFoundException; 
import spittr.Spitter; 
import spittr.data.SpitterRepository; 


public class SpitterUserService implements UserDetailsService { 


private final SpitterRepository spitterRepository; 注入 
public SpitterUserService(lSpitterRepository spitterRepository) { Rt 
this.spitterRepository = spitterRepository; posMom 


@Override 
public UserDetails loadUserByUsername (String username) 





hrows UsernameNotFoundException { 查找 Spitter 
spitter = spitterRepository.findByUsername (username); 


tter != null) 





1 
-<GrantedAuthority> authorities = 创建 
new ArrayList <GrantedAuthority>(); 权限 列表 
i { 9 ) 是 -~ "| 4 
authorities ,addalnew SimpleGrantedAuthority!{("ROLE_SPITTER")); ~ 
return new User! 
4 ' 1 
spitter.getUsername(), 返回 User 
spitter.getPassword!{(), 
authorities); 
} 
throw new UsernameNotFoundException! 
"User '" -+ username + "' not found."); 


} 


SpitterUserService 有 意思 的 地 方 在 于 它 并 不 知道 用 户 数据 存储 在 什 

么 地 方 。 设 置 进来 的 SpitterRepository 能 够 从 关系 型 数据 库 、 文 档 

数据 库 或 图 数据 中 查找 spitter 对 象 ， 甚 至 可 以 伪造 一 

A SpitterUserService 个 知道 也 不 会 关 ， 心底 层 所 使 用 的 数据 存储 。 
只 是 获得 Spitter 对 象 ， 它 来 创建 User 对 象 。 (User 

瑟 Usernataiis 的 只 保 于 克 ， 


为 了 使 用 SpitterUserService 来 认证 用 户 ， 我 们 可 以 通过 
userDetailsService() 方 法 将 其 设置 到 安全 配置 中 : 


@Autowired 
SpitterRepository spitterRepository; 


@Override 


protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.UserDetailsService(new SpitterUserService(spitterRepository)); 





userDetailsService() 方 法 (类 似 于 
jdbcAuthentication()、1dapAuthentication 以 及 
inMemoryAuthentication()) 会 配置 一 个 用 户 存 储 。 不 过 ， 这 里 所 使 
用 的 不 是 Spring 所 提供 的 用 户 存 储 ， 而 是 使 用 UserDetailsservice 的 
实现 。 








另外 一 种 值得 考虑 的 方案 就 是 修改 Spitter， 计 其 实现 UserDetails。 
这 样 的 话 ，loadUserByUsername( ) 就 能 直接 返回 spitter 对 象 了 ， 而 
不 必 再 将 它 的 值 复制 到 User 对 象 中 。 


9.3 ”拦截 请 求 


在 前 面 的 9.1.3 小 节 中 ， 我 们 看 到 一 个 特别 简单 的 Spring Security 配 置 ， 

在 这 个 默认 的 配置 中 ， 会 要 求 所 有 请 求 都 要 经 过 认证 。 有 些 人 可 能 会 
说 ， 过 多 的 安全 性 总 比 安全 性 太 少 要 好 。 但 也 有 一 种 说 法 就 是 要 适量 地 
应 用 安全 性 。 


在 任何 应 用 中 ， 并 不 是 所 有 的 请 求 都 需要 同等 程度 地 保护 。 有 些 请 求 需 
要 认证 ， 而 男 一 些 可 能 并 不 需要 。 有 些 请 求 可 能 只 有 具备 特定 权限 的 用 
户 才 能 访问 ， 没 有 这 些 权 限 的 用 户 会 无 法 访问 。 


例如 ， 考 虑 Spitr 应 用 的 请 求 。 首 页 当然 是 公开 的 ， 不 需要 进行 保护 。 

类 似 地 ， 因 为 所 有 的 Spittle 都 是 公开 的 ， 所 以 展现 spittle 的 页 面 不 
需要 安全 性 。 但 是 ， 创 建 sSpittle 的 请 求 只 有 认证 用 户 才能 执行 。 同 

样 ， 尽 管用 户 基本 信息 页 面 是 公开 的 ， 不 需要 认证 ， 但 是 ， 如 宋 要 处 

理 “/spitters/me” 请 求 ， 并 展现 当前 用 户 的 基本 信息 时 ， 那 么 束 需 要 进行 
认证 ， 从 而 确定 要 展现 谁 的 信息 。 


对 每 个 请 求 进行 细 粒 度 安 全 性 控制 的 关键 在 于 重 

载 configure(HttpSecurity) 方 法 。 如 下 的 代码 片段 展现 了 重 载 的 
configure(HttpSecurity) 方 法 ， 它 为 不 同 的 URL 路 径 有 选择 地 应 用 
安全 性 : 


























@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 


.antMatchers("/spitters/me").authenticated() 
.antMatchers(HttpMethod.POST, "/spittles").authenticated() 
.anyRequest().permitAll(); 





configure() 方 法 中 得 到 的 HttpSecurity 对 象 可 以 在 多 个 方面 配置 
HTTP 的 安全 性 。 在 这 里 ， 我 们 首先 调用 authorizeRequests()， 然 后 
调用 该 方法 所 返回 的 对 象 的 方法 来 配置 请 求 级 别 的 安全 性 细节 。 其 中 ， 
第 一 次 调用 antMatchers() 指 定 了 对 “spittersmme” 路 径 的 请 求 需 要 进行 
认证 。 第 二 次 调用 antMatchers() 更 为 具体 ， 说 明 对 ”spittles” 路 径 的 


HTTP POST 请 求 必 须要 经 过 认证 。 最 后 对 anyRequests() 的 调用 中 ， 
说 明 其 他 所 有 的 请 求 都 是 允许 的 ， 不 需要 认证 和 任何 的 权限 。 


antMatchers () 方 法 中 设 定 的 路 径 文 持 Ant 风 格 的 通配符 。 在 这 里 我 们 
并 没有 这 样 使 用 ， 但 是 也 可 以 使 用 通配符 来 指定 路 径 ， 如 下 所 示 : 


.antMatchers("/spitters/**").authenticated(); 


我 们 也 可 以 在 一 个 对 antMatchers() 方 法 的 调用 中 指定 多 个 路 径 : 





.antMatchers("/spitters/**", "/spittles/mine").authenticated(); 


antMatchers() 方 法 所 使 用 的 路 径 可 能 会 包括 Ant 风 格 的 通配符 ， 而 
regexMatchers() 方 法 则 能 够 接受 正则 表达 式 来 定义 请 求 路 径 。 例 如 ， 如 
A 的 正则 表达 式 与 “/spitters/**”( Ant 风 格 〉 功 能 是 相同 


.regexMatchers("/spitters/.*").authenticated(); 


除了 路 径 选 择 ， 我 们 还 通过 authenticated() 和 permitAl1() 来 定义 

该 如 何 保 护 路 径 。authenticated() 要 求 在 执行 该 请 求 时 ， 必 须 已 经 

登录 了 应 用 。 如 果 用 户 没 有 认证 的 话 ，Spring Security 的 Filter 将 会 捕获 

该 请 求 ， 并 将 用 户 重 定向 到 应 用 的 登录 页 面 。 同 时 ，permitAl1() 方 法 
允许 请 求 没 有 任何 的 安全 限制 。 


除了 authenticated() 和 permitAl1() 以 外 ， 还 有 其 他 的 一 些 方法 能 
够 用 来 定义 该 如 何 保 护 请 求 。 表 9.4 描 述 了 所 有 可 用 的 方案 。 


表 9.4 用 来 定义 如 何 保护 路 径 的 配置 方法 


能 够 做 什么 


access(String) 如 果 给 定 的 SpEL 表 达 式 计算 结果 为 rue， 就 允许 访问 












































authenticated() 允许 认证 过 的 用 户 访 问 



































, 如 果 用 户 是 完整 认证 的 话 〈 不 是 通过 Remember-me 功 能 
fullyAuthenticated() 认证 的 ) ， 就 允许 访问 












































ese | am 4 失守 权限 中 的 某 一 个 的 话 ， 训 多 放 访 
temic 【 备 给 定 角 色 中 的 上 就 允许 访问 
















































































homers 备 给 定 权 限 的 话 ， 就 允许 访问 
如 果 请 求 来 自给 定 IP 地 址 的 话 ， 就 允许 访问 
homes 备 给 定 角 色 的 话 ， 就 允许 访问 
mo 他 访问 方法 的 结果 求 反 
天 条 件 多 许 沪 

是 通过 Remember-me 功 能 认证 的 ， 就 允许 访问 


通过 使 用 表 9.4 中 的 方法 ， 我 们 所 配置 的 安全 性 能 够 不 仅仅 限于 认证 用 
户 。 例 如 ， 我 们 可 以 修改 之 前 的 configure( ) 方 法 ， 要 求 用 户 不 仅 需 要 
认证 ， 还 要 具备 ROLE_SPITTER 权 限 : 
















































































@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 
.antMatchers("/spitters/me").hasAuthority("ROLE_ SPITTER") 
.antMatchers(HttpMethod.POST, "/spittles") 


.hasAuthority("ROLE_ SPITTER") 


.anyRequest().permitAll(); 





作为 蔡 代 方案 ， 我 们 还 可 以 使 用 hasRole() 方 法 ， 它 会 自动 使 
用 “ROLE ?前 绥 ; 


@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.authorizeRequests() 


.antMatchers("/spitter/me").hasRole("SPITTER") 
.antMatchers(HttpMethod.POST, "/spittles").hasRole("SPITTER") 
.anyRequest().permitAll(); 





我 们 可 以 将 任意 数量 的 antMatchers()、regexMatchers() 和 
anyRequest() 连 接 起 来 ， 以 满足 Web 应 用 安全 规则 的 需要 。 但 是 ， 我 
们 需要 知道 ， 这 些 规则 会 按照 给 定 的 顺序 发 挥 作用 。 所 以 ， 很 重要 的 一 
点 驶 是 将 最 为 具体 的 请 求 路 径 放 在 前 面 ， 而 最 不 具体 的 路 径 〈 如 
anyRequest() ) 放 在 最 后 面 。 如 果 不 这 样 做 的 话 ， 那 不 具体 的 路 径 配 
置 将 会 履 盖 掉 更 为 具体 的 路 径 配 置 。 


9.3.1 使 用 Spring 表达 式 进行 安全 保护 


表 9.4 中 的 大 多 数 方法 都 是 一 维 的 ， 也 就 是 说 我 们 可 以 使 用 hasRole() 限 
制 某 个 特定 的 角色 ， 但 是 我 们 不 能 在 相同 的 路 径 上 同时 通过 
hasIpAddress() 限 制 特 定 的 耳 地 址 。 


另外 ， 除 了 表 9.4 定 义 的 方法 以 外 ， 我 们 没有 办 法 使 用 其 他 的 条 件 。 如 
果 我 们 希望 限制 某 个 角色 只 能 在 星期 二 进行 访问 的 话 ， 该 怎么 办 呢 ? 


在 第 3 章 中 ， 我 们 看 到 了 如 何 使 用 Spring 表达 式 语言 (Spring Expression 
Language，SpEL) ， 将 其 作为 装配 bean 属 性 的 高 级 技术 。 借 助 
access() 方 法 ， 我 们 也 可 以 将 SpEL 作 为 声明 访问 限制 的 一 种 方式 。 例 
如 ， 如 下 就 是 使 用 SpEL 表 达 式 来 声明 具有 “ROLE_SPITTER” 角 色 才 能 
访问 “/spitter/me”URL: 

















.antMatchers("/spitter/me").access("hasRole('ROLE SPITTER' )") 





这 个 对 “/spitter/me” 的 安全 限制 与 开始 时 的 效果 是 等 价 的 ， 只 不 过 这 里 使 
用 了 SpEL 来 摘 述 安全 规则 。 如 果 当 前 用 户 被 授予 了 给 定 角色 的 话 ， 那 
hasRole() 表 达 式 的 计算 结果 就 为 true。 


让 SpEL 更 强大 的 原因 在 于 ，hasRole() 仅 是 Spring 支持 的 安全 相关 表达 
式 中 的 一 种 ， 表 9.5 列 出 了 Spring Security 支 持 的 所 有 SpEL 表 达 式 。 


表 9.5 ”Spring Security 通 过 一 些 安 全 性 相关 的 表达 式 扩 展 了 Spring 表达 式 语 言 


hasAnyRole(1ist of 如 果 用 户 被 授予 了 列表 中 任意 的 指定 角色 ， 经 


roles) 












































hasRole(role) 如 果 用 户 被 授予 了 指定 的 角色 ， 结 果 为 true 








hasIpAddress(IP : 主 <>s Ee ja 
Address) 如 果 请 求 来 自 指 定 卫 的 话 ， 





isAnonymous () 如 果 当 前 用 户 为 结果 为 true 



































isAuthenticated() ] 户 进行 了 认证 的 话 ， 结 果 为 true 














、 . 如 果 当 前 用 户 进行 了 完整 认证 的 话 〈 不 是 通过 Remember-me 
isFullyAuthenticated() 功能 进行 的 认证 ) ， 结 果 为 true 











isRememberMe() [ 果 当 前 用 户 是 通过 Remember-me 自 动 认证 的 ， 结 果 为 true 











permitAll 结果 始终 为 true 





principal 用 户 的 principal 对 象 


在 掌握 了 Spring Security 的 SpEL 表 达 式 后 ， 我 们 束 能 够 不 再 局 限于 基于 
用 户 的 权限 进行 访问 限制 了 。 例 如 ， 如 果 你 想 限 制 “/spitter/me”URL 的 
访问 ， 不 仅 需 要 ROLE_SPITTER， 还 需要 来 自 指定 的 IP 地 址 ， 那 么 我 们 
可 以 按照 如 下 的 方式 调用 access() 方 法 : 














.antMatchers("/spitter/me") 


.access("hasRole('ROLE SPITTER') and hasIpAddress('192.168.1.2')") 





我 们 可 以 使 用 SpEL 实 现 各 种 各 样 的 安全 性 限制 。 我 敢 打赌 ， 你 已 经 在 
想象 基于 SpEL 所 能 实现 的 那些 有 趣 的 安全 性 限制 了 。 


但 现在 ， 让 我 们 看 一 下 Spring Security 拦 截 请 求 的 另外 一 种 方式 : 强制 
通道 的 安全 性 。 


9.3.2 ”强制 通道 的 安全 性 


使 用 HTTP 提 交 数 据 是 一 件 具 有 风险 的 事情 。 如 果 使 用 HTTP 发 送 无 关 紧 
要 的 信息 ， 这 可 能 不 是 什么 大 问题 。 但 是 如 果 你 通过 HTTP 发 送 诸 如 密 
码 和 信用 卡号 这 样 的 敏感 信息 的 话 ， 那 你 束 是 在 找 贱 上 病 了 。 通 过 HTTP 
发 送 的 数据 没有 经 过 加 密 ， 黑 客 就 有 机 会 拦截 请 求 并 且 能 够 看 到 他 们 想 
看 的 数据 。 这 就 是 为 什么 敏感 信息 要 通过 HTTPS 来 加 密 发 送 的 原因 。 


使 用 HTTPS 似 乎 很 简单 。 你 要 做 的 事情 只 是 在 URL 中 的 HITP 后 加 上 一 
个 字母 “s” 就 可 以 了 。 是 这 样 吗 ? 


这 是 真 的 ， 但 这 是 把 使 用 HTTPS 通 道 的 责任 放 在 了 错误 的 地 方 。 通 过 添 
加 “s” 我 们 残 能 很 容易 地 实现 页 面 的 安全 性 ， 但 是 态 记 添加 “s” 同 样 也 是 
很 容易 出 现 的 。 如 果 我 们 的 应 用 中 有 多 个 链接 需要 HITPS， 佑 计 在 其 中 
的 一 两 个 上 坏 记 添加 “s” 的 概率 还 是 很 高 的 。 


另 一 方面 ， 你 可 能 还 会 在 原本 并 不 需要 HTTPS 的 地 方 ， 误 用 HTTPS 。 
传递 到 configure() 方 法 中 的 HttpSecurity 对 象 ， 除 了 上 


有 authorizeRequests() 方 法 以 外 ， 还 有 一 个 requiresChannel() 方 
法 ， 借 助 这 个 方法 能 够 为 各 种 URL 模 式 声 明 所 要 求 的 通道 。 

















作为 示例 ， 可 以 参考 Spittr 应 用 的 注册 表单 。 尽 管 Spittr 应 用 不 需要 信用 
卡号 、 社 会 保障 号 或 其 他 特别 敏感 的 信息 ， 但 用 户 有 可 能 仍然 希望 信息 
是 私密 的 。 为 了 保证 注册 表单 的 数据 通过 HITPS 传 送 ， 我 们 可 以 在 配置 
中 添加 requiresChannel() 方 法 ， 如 下 所 示 : 








程序 清单 9.5” ”requiresChannel() 方 法 会 为 选 定 的 URL 强 制 使 用 HTTPS 


erride 





.requliresCha BLt{)} 
.antMatchers("/spitter/form'") .requiresSecure!(); 需要 HTTPS 


不 论 何 时 ， 只 要 是 对 “/spitter/form” 的 请 求 ，Spring Security 都 视 为 需要 安 
全 通道 (通过 调用 requiresChannel( ) 确 定 的 ) 并 自动 将 请 求 重 定向 
到 HTTPS 上 。 


与 之 相反 ， 有 些 页 面 并 不 需要 通过 HTTPS 传 送 。 例 如 ， 首 页 不 包含 任何 
敏感 信息 ， 因 此 并 不 需要 通过 HTTPS 传 送 。 我 们 可 以 使 

用 requiresInsecure() 代 替 requiresSsecure() 方 法 ， 将 首页 声明 为 
始终 通过 HTTP 传 送 : 


.antMatchers("/").requiresInecure(); 


如 果 通 过 HTTPS 发 送 了 对 “/” 的 请 求 ，Spring Security 将 会 把 请 求 重 定 问 
到 不 安全 的 HTTP 通 道上 。 


在 强制 要 求 通道 时 ， 路 径 的 选取 方案 与 authorizeRequests() 是 相同 
的 。 在 程序 清单 9.5 中 ， 使 用 了 antMatches()， 但 我 们 也 可 以 使 
用 regexMatchers() 方 法 ， 通 过 正则 表达 式 选 取 路 径 模式 。 


9.3.3 ”防止 跨 站 请 求 伪 造 
我 们 可 以 回忆 一 下 ， 当 一 个 POST 请 求 提 交 到 “spittles” 上 


时 ，SpittleController 将 会 为 用 户 创建 一 个 新 的 Spittle 对 象 。 但 是 ， 
如 果 这 个 POST 请 求 来 源 于 其 他 站 点 的 话 ， 会 怎么 样 呢 ? 如 果 在 其 他 站 点 











提交 如 下 表单 ， 这 个 POST 请 求 会 造成 什么 样 的 结果 呢 ? 


<form method="POST" action="http://www.spittr.com/spittles"> 
<input type="hidden" name="message" value="I'm stupid!" /> 


<input type="submit" value="Click here to win a new car!" /> 
</form> 








假设 你 禁不住 获得 一 辆 新 汽车 的 诱惑 ， 点 击 了 按钮 一 一 那么 你 将 会 提交 
表单 到 如 下 地 址 http://www.spittr.com/spittles。 如 果 你 已 经 登录 到 了 
spittr.com， 那 么 这 就 会 广播 一 条 消息 ， 让 每 个 人 都 知道 你 做 了 一 件 蠢 
事 。 





这 是 跨 站 请 求 伪造 〈cross-site request forgery，CSRF) 的 一 个 简单 样 
例 。 简 单 来 讲 ， 如 果 一 个 站 点 欺骗 用 户 提 交 请 求 到 其 他 服务 器 的 话 ， 就 
会 发 生 CSRF 攻 击 ， 这 可 能 会 带 来 消极 的 后 果 。 尺 管 提 交 “T’m stupid!” 这 
样 的 信息 到 微 博 站 点 算 不 上 什么 CSRF 攻 击 的 最 糟糕 场景 ， 但 是 你 可 以 
1 它 可 能 会 对 你 的 银行 账号 执行 难以 预 
多 jj 日 控 人 和 F。 


从 Spring Security 3.2 开 始 ， 黑 认 就 会 月 用 CSREF 防 护 。 实 际 上 ， 除 非 你 采 
取 行 为 处 理 CSRF 防 护 或 者 将 这 个 功能 蔡 用 ， 人 否则 的 话 ， 在 应 用 中 提交 
表单 时 ， 你 可 能 会 过 到 问题 。 


Spring Security 通 过 一 个 同步 token 的 方式 来 实现 CSRE 防 护 的 功能 。 它 将 
会 拦截 状态 变化 的 请 求 〈 例 如 ， 非 GET、HEAD、0OPTIONS 和 TRACE 的 请 
求 ) 并 检查 CSREF token。 如 果 请 求 中 不 包含 CSRF token 的 话 ， 或 者 token 
不 能 与 服务 器 端的 token 相 匹配 ， 请 求 将 会 失败 ， 并 抛 出 


CsrfException 异 常 。 


这 意味 着 在 你 的 应 用 中 ， 所 有 的 表单 必须 在 一 个 “_csrf” 域 中 提交 
token， 而 且 这 个 token 必 须要 与 服务 器 端 计 算 并 存储 的 token 一 致 ， 这 样 
的 话 当 表单 提交 的 时 候 ， 才 能 进行 匹配 。 


好 消息 是 ，Spring Security 已 经 简化 了 将 token 放 到 请 求 的 属性 中 这 一 任 
务 。 如 果 你 使 用 Thymeleaf 作 为 页 面 模板 的 话 ， 只 要 <form> 标 签 的 
action 属 性 添加 了 Thymeleaf 命 名 空间 前 级 ， 那 么 就 会 自动 生成 一 

个 “_csrf” 隐 藏 域 : 








<form method="POST" th:action="@{/spittles}"> 


</form> 








如 果 使 用 JSP 作 为 页 面 模 板 的 话 ， 我 们 要 做 的 事情 非常 类 似 : 


<input type="hidden" 
name="${_csrf.parameterName}" 


value="${ _csrf.token}"” /> 





更 好 的 功能 是 ， 如 果 使 用 Spring 的 表单 绑 定 标签 的 话 ，《<sf:form> 标 签 
会 自动 为 我 们 添加 隐藏 的 CSRF token 标 签 。 


处 理 CSRF 的 另外 一 种 方式 就 是 根本 不 去 处 理 它 。 我 们 可 以 在 配置 中 通 
过 调用 csrf() .disable() 禁 用 Spring Security 的 CSRF 防 护 功 能 ， 如 下 
所 示 : 


程序 清单 9.6 我们 可 以 禁用 Spring Security 的 CSRE 防 护 功能 








@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 


disable(); 禁用 CSRF 防护 功能 


需要 提醒 的 是 ， 禁 用 CSRF 防 护 功能 通常 来 讲 并 不 是 一 个 好 主意 。 如 果 
这 样 做 的 话 ， 那 么 应 用 就 会 面临 CSRF 攻 击 的 风险 。 只 有 在 深思 熟 虑 之 
后 ， 才 能 使 用 程序 清单 9.6 中 的 配置 。 


我 们 已 经 配置 好 了 用 户 存储 ， 也 配置 好 了 使 用 Spring Security 来 拦截 请 
求 ， 那 么 接 下 来 就 该 提示 用 户 输入 凭证 了 。 





9.4 认证 用 户 


如 果 你 使 用 程序 清单 9.1 中 最 简单 的 Spring Security 配 置 的 话 ， 那 么 就 能 
无 偿 地 得 到 一 个 登录 页 。 实 际 上 ， 在 重 写 configure(HttpSecurity ) 
之 前 ， 我 们 都 能 使 用 一 个 简单 却 功能 完备 的 登录 页 。 但 是 ， 一 旦 重 写 了 
configure(HttpSecurity) 方 法 ， 束 失去 了 这 个 简单 的 登录 页 面 。 


不 过 ， 把 这 个 功能 找 回来 也 很 容易 。 我 们 所 需要 做 的 就 是 
在 configure(HttpSecurity) 方 法 中 ， 调 用 formLogin()， 如 下 面 的 
程序 清单 所 示 。 


和 前 面 一 样 ， 这 里 调用 add( ) 方 法 来 将 不 同 的 配置 指令 连接 在 
一 起 。 

如 采 我 们 访问 应 用 的 %login” 链 接 或 者 导航 到 需要 认证 的 页 面 ， 那 么 将 
会 在 浏览 器 中 展现 登录 页 面 。 如 图 9.2 所 示 ， 在 审美 上 它 没有 什么 令 人 
兴奋 的 ， 但 是 它 却 能 实现 所 需 的 功能 。 


程序 清单 9.7 formLogin() 方 法 启用 了 基本 的 登录 页 功能 











GOverride 
protected void configure(HEtPSecurity http) throws Exception { 
http 
formLogin() 启用 默认 的 登录 页 
.and() 


.authorizeRequests{() 
.antMatchers("/spitter/me") .hasRole ("SPITTER") 


.antMatchers (HttpMethod.POST, "/spittles") .hasRole("SPITTER") 
.anyRequest () .permitAll(); 
.and() 


.requiresChannel {) 
.antMatchers("/spitter/form") .requiresSecure!(); 


Qn Login Page 
[此 | + | localhost:8080 c ia 


i with Username and pao 








User: 
Password: 


Login 























图 9.2 默认 的 登录 页 在 审美 上 过 于 简陋 ， 但 是 功能 完 


我 敢 打赌 ， 你 肯定 希望 在 自己 的 应 用 程序 中 能 有 一 个 比 默认 登录 页 更 漂 
腕 的 登录 页 面 。 如 果 这 个 普通 的 登录 页 面 破坏 了 我 们 原本 精心 设计 的 漂 

亮 站 点 ， 那 真 的 是 件 很 令 人 遗憾 的 事情 。 没 问题 ! 接 下 来 ， 我 们 残 看 一 
下 如 何 为 应 用 添加 自 定 义 的 登录 页 面 。 


9.4.1 添加 目 定 义 的 登录 页 


创建 自 定义 登录 页 的 第 一 步 就 是 了 解 登录 表单 中 都 需要 些 什么 。 只 需 看 
一 下 默认 登录 页 面 的 HTML 源 码 ， 我 们 就 能 了 解 需要 些 什么 ; 

















<html> 
<head><title>Login Page</title></head> 
<body onload='document.f.username.focus();'> 
<h3>Login with Username and Password</h3> 
<form name='f' action='/spittr/login' method=' POST ' > 
<table> 
<tr><td>User:</td><td> 
<input type='text' name='Uusername' value=''></td></tr> 
<tr><td>Password:</td> 


<td><input type="'password' name="'password'/></td></tr> 
<tr><td colspan= '2 > 
<input name="submit" type="submit" value="Login"/></td></tr> 
<input name=” csrf" type="hidden" 
value="6829b1lae-6a14-4926-aac4-5abbd7eeb9ee" /> 


</table> 
</form> 
</body> 
</html> 








需要 注意 的 一 个 关键 点 是 <form> 提 交 到 了 什么 地 方 。 同 时 还 需要 注意 
username 和 password 输 入 域 ， 在 你 的 登录 页 中 ， 需 要 同样 的 输入 域 。 最 
后 ， 假 设 没 有 禁用 CSRF 的 话 ， 还 需要 保证 包含 了 值 为 CSRF token 

的 “_csrf” 输 入 域 。 


如 下 程序 清单 所 展现 的 Thymeleaf 模 板 提供 了 一 个 与 Spitr 应 用 风格 一 致 
的 登录 页 。 


程序 清单 9.8 ”为 Spittr 应 用 编写 的 自 定 义 登录 页 《以 Thymeleaf 模 板 的 
形式 ) 





<htrml xmlns="http://www.w3.org/1999/xhtml" 
xmlns:th="http://www.thymeleaf .org"> 
<head> 
<title>Spitter</title> 


<link rel="styles 





type="text/css 
h:href="@{/resources/style.css}"></link> 
</head> 
<body onload='document.f.username.focus{);'> 
<Qiv id="header" th:include="page :: header"></div> 
<Qiv id="content"> 
<form name='f' th:action='@{/login}' method='POST'> 是 交 到 “/login™ 
<table> 





<tr><td>User:</td><td> 
<input + 上 YX Xt name='USername' Value='' /></td></tr> 
tr><td>Pas ta 
<td><inpu ype='password’' name='password'/></td></tr> 


<tr><td colspan='2'> 
<input name="submit" type="submit" value="Login"/></td></tr> 
</table> 
</form> 
</div> 
<div id="footer" th:include="page :: copy"></div> 
</body> 


</html> 


需要 注意 的 是 ， 在 Thymeleaf 模 板 中 ， 包 含 了 username 和 password 输 入 
域 ， 惑 像 默 认 的 登录 页 一 样 ， 它 也 提交 到 了 相对 于 上 下 文 的 %login” 页 
面 上 。 因 为 这 是 一 个 Thymeleaf 模 板 ， 因 此 隐藏 的 ”csrf” 域 将 会 自动 添 
加 到 表单 中 。 


9.4.2 ”启用 HTTP Basic 认 证 
对 于 应 用 程序 的 人 类 用 户 来 说 ， 基 于 表单 的 认证 是 比较 理想 的 。 但 是 在 


第 16 章 中 ， 将 会 看 到 如 何 将 我 们 Web 应 用 的 页 面 转化 为 RESTful API。 
当 应 用 程序 的 使 用 者 是 另外 一 个 应 用 程序 的 话 ， 使 用 表单 来 提示 登录 的 








方式 就 不 太 适 合 了 。 


HTTP Basic 认 证 CHTTP Basic _ Authentication ) 会 直接 通过 HTTP 请 求 本 

身 ， 对 要 访问 应 用 程序 的 用 户 进行 认证 。 你 可 能 在 以 前 见 过 HTTP Basic 
认证 。 当 在 Web 浏 览 器 中 使 用 时 ， 它 将 同 用 户 弹 出 一 个 简单 的 模 态 对 话 
框 。 


但 这 只 是 Web 浏览 句 的 显示 方式 。 本 质 上 ， 这 是 一 个 HITP 401 啊 应 ， 表 
明 必 须要 在 请 求 中 包含 一 个 用 己 名 和 密码 。 在 REST 客 户 端 癌 它 使 用 的 
服务 进行 认证 的 场景 中 ， 这 种 方式 比较 适合 。 


如 果 要 局 用 HTTP Basic 认 证 的 话 ， 只 需 在 configure() 方 法 所 传 入 的 
Httpsecurity 对 象 上 调用 httpBasic() 即 可 。 另 外 ， 还 可 以 通过 调 
用 realmName() 方 法 指定 域 。 如 下 是 在 Spring Security 中 启用 HTTP 
Basic 认 证 的 典型 配置 : 

















@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.formLogin() 


.loginpage("/login") 
.and() 
.httpBasic() 
.realmName ("Spittr") 
.and() 





注意 ， 和 前 面 一 样 ， 在 configure( ) 方 法 中 ， 通 过 调用 add( ) 方 法 来 将 
不 同 的 配置 指令 连接 在 一 起 。 


在 httpBasic() 方 法 中 ， 并 没有 太 多 的 可 配置 项 ， 甚 至 不 需要 什么 额外 
配置 。HTTP Basic 认 证 要 么 开启 要 么 关闭 。 所 以 ， 与 其 进一步 研究 这 个 
话题 ， 还 不 如 看 看 如 何 通 过 Remember-me 功 能 实现 用 户 的 自动 认证 。 





9.4.3 ”启用 Remember-me 功 能 


对 于 应 用 程序 来 讲 ， 能 够 对 用 户 进 行 认证 是 非常 重要 的 。 但 是 站 在 用 户 
的 角度 来 讲 ， 如 果 应 用 程序 不 用 每 次 都 提示 他 们 登录 是 更 好 的 。 这 就 是 
为 什么 许多 站 点 提供 了 Remember-me 功 能 ， 你 只 要 登录 过 一 次 ， 应 用 就 








会 记 住 你 ， 当 再 次 回 到 应 用 的 时 候 你 就 不 需要 登录 了 。 


Spring Security 使 得 为 应 用 添加 Remember-me 功 能 变 得 非常 容易 。 为 了 启 
用 这 项 功能 ， 只 需 在 configure() 方 法 所 传 入 的 HttpSecurity 对 象 上 
调用 rememberMe() 即 可 。 





@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.formLogin() 
.loginpage("/login") 


.and() 

.rememberMe() 
.tokenValiditySeconds(24192808) 
.key("spittrkey") 








在 这 里 ， 我 们 通过 一 点 特殊 的 配置 就 可 以 司 用 Remember-me 功 能 。 默 认 
情况 下 ， 这 个 功能 是 通过 在 cookie 中 存储 一 个 token 完 成 的 ， 这 个 token 最 
多 两 周 内 有 效 。 但 是 ， 在 这 里 ， 我 们 指定 这 个 token 最 多 四 周 内 有 效 
(2,419,200 秒 ) 。 


存储 在 cookie 中 的 token 包 含 用 户 名 、 密 码 、 过 期 时 间 和 一 个 私 钥 一 一 在 
写 入 cookie 前 都 进行 了 MD5 哈 希 。 默 认 情 况 下 ， 私 钥 的 名 

为 SpringSecured， 但 在 这 里 我 们 将 其 设置 为 spitterKey， 使 它 专门 
用 于 Spittr 应 用 。 


如 此 简单 。 既 然 Remember-me 功 能 已 经 启用 ， 我 们 需要 有 一 种 方式 来 让 
用 户 表 明 他 们 和 希望 应 用 程序 能 够 记 住 他 们 。 为 了 实现 这 一 点 ， 登 录 请 求 
必须 包含 一 个 名 为 remember-me 的 参数 。 在 登录 表单 中 ， 增 加 一 个 简单 
复 选 框 就 可 以 完成 这 件 事情 : 





<input id="remember me" name="remember-me" type="checkbox"/> 





<label for="remember me" class="inline">Remember me</label> 





在 应 用 中 ， 与 登录 同等 重要 的 功能 就 是 退出 。 如 果 你 局 用 Remember-me 
功能 的 话 ， 更 是 如 此 ， 否 则 的 话 ， 用 户 将 永远 登录 在 这 个 系统 中 。 我 们 
下 面 将 看 一 下 如 何 添加 退 ”出 功能 。 


9.4.4 退出 


其 实 ， 按 照 我 们 的 配置 ， 退 出 功能 已 经 启用 了 ， 不 需要 再 做 其 他 的 配置 
了 。 我 们 需要 的 只 是 一 个 使 用 该 功能 的 链接 。 


退出 功能 是 通过 Servlet 容 器 中 的 Filter 实 现 的 〈 默 认 情 况 下 ) ， 这 个 Filter 
会 拦截 针对 “/logout” 的 请 求 。 因 此 ， 为 应 用 添加 退出 功能 只 需 添 加 如 下 
的 链接 即 可 (如 下 以 Thymeleaf 代 码 片 段 的 形式 进行 了 展现 ) : 


<a th:href="@{/logout}">Logout</a> 


当 用 户 点 击 这 个 链接 的 时 候 ， 会 发 起 对 %logout” 的 请 求 ， 这 个 请 求 会 被 
Spring Security 的 LogoutFilter 所 处 理 。 用 户 会 退出 应 用 ， 1 
Remember-me token 都 会 被 清除 掉 。 在 退出 完成 后 ， 用 户 浏 览 器 将 会 

定 同 到 “/login?logout*”， 从 而 允许 用 户 进 行 再 次 登录 。 


如 果 你 希望 用 户 被 重 定 同 到 其 他 的 页 面 ， 如 应 用 的 首页 ， 那 么 可 以 
在 configure() 中 进行 如 下 的 配置 : 








@Override 
protected void configure(HttpSecurity http) throws Exception { 
http 
.formLogin() 
.loginpage("/login") 


.and() 
.logout() 
.logoutSuccessUr1l("/") 





在 这 里 ， 和 前 面 一 样 ， 通 过 add( ) 连 接 起 了 对 logout() 的 调 

用 。1logout() 提 供 了 配置 退出 行为 的 方法 。 在 本 例 中 ， 调 

用 logoutsuccessUr1() 表 明 在 退出 成 功 之 后 ， 浏 览 器 需要 重 定 问 
到 “/”。 


除了 logoutsuccessUr1() 方 法 以 外 ， 你 可 能 还 布 望 重 号 默认 的 
LogoutFilter 拦 截 路 径 。 我 们 可 以 通过 调用 logoutUr1l() 方 法 实现 这 
一 功能 : 





.logout() 
.logoutSuccessUr1l("/") 





.logoutUrl("/signout") 








到 目前 为 止 ， 我 们 已 经 看 到 了 如 何在 发 起 请 求 的 时 候 保 护 Web 应 用 。 这 
假设 安全 性 主要 涉及 阻止 用 户 访 问 没 有 权限 的 URL。 但 是 ， 如 果 我 们 能 
够 不 给 用 户 显 示 其 无 权 访问 的 连接 ， 那 么 这 也 是 一 个 很 好 的 思路 。 接 下 
来 ， 我 们 将 会 看 一 下 如 何 添加 视图 级 别 的 安全 性 。 








9.5 保护 视图 


当 为 浏览 器 泻 染 HTML 内容 时 ， 你 可 能 希望 视图 中 能 够 反映 安全 限制 和 
相关 的 信息 。 一 简单 的 样 例 就 是 演 染 采用 户 的 基本 信息 《比如 显示 “您 
己 经 以 ...... 身 份 登录 ) 。 或 者 你 想 根据 用 户 被 授予 了 什么 权限 ， 有 条 
件 地 泻 染 洒 特 定 的 视图 元 素 。 


在 第 6 章 ， 我 们 看 到 了 在 Spring MVC 应 用 中 泻 染 视图 的 两 个 最 重要 的 可 

选 方案 : JSP 和 Thymeleaf。 不 管 你 使 用 哪 种 方案 ， 都 有 办 法 在 视图 上 实 
现 安全 性 。Spring Security 本 里 提供 了 一 个 JSP 标 签 库 ， 而 Thymeleaf 通 过 
特定 的 方言 实现 了 与 Spring Security 的 集成 。 


让 我 们 看 一 下 如 何 将 Spring Security 用 到 视图 中 ， 就 从 Spring Security 的 
JSP 标 签 库 开始 吧 。 














9.5.1 使 用 Spring Security 的 JSP 标 签 库 


Spring Security 的 JSP 标 签 库 很 小 ， 只 包含 三 个 标签 ， 如 表 9.6 所 示 。 








表 9.6 ”Spring Security 通 过 JSP 标 签 库 在 视图 层 上 支持 安全 性 


JSP 标 签 


如 采用 :通过 访问 控制 列表 授予 了 指定 的 权限 ， 那 么 


<security:accesscontrollist> 
’ 泻 染 该 标签 体 中 的 内 容 


























演 染 当前 用 户 认证 对 象 的 详细 信息 


如 果 用 户 被 授予 了 特定 的 权限 或 者 SpEL 表 达 式 的 计算 


<security:authorize> 乡 


结果 为 tue， 那 么 演 染 该 标签 体 中 的 内 容 














为 了 使 用 JSP 标 签 库 ， 我 们 需要 在 对 应 的 JSP 中 声明 它 


<%@ taglib prefix="security" 


uri="http://www.springframework.org/security/tags" %> 








只 要 标签 库 在 JSP 文 件 中 进行 了 声明 ， 我 们 就 可 以 使 用 它 了。 让 我 们 看 
看 Spring Security 提 供 的 这 三 个 标签 是 如 何 工 作 的 。 


访问 认证 信息 的 细节 





借助 Spring Security JSP 标 签 库 ， 所 能 做 到 的 最 简单 的 一 件 事情 束 是 便利 
地 访问 用 户 的 认证 信息 。 例 如 ， 对 于 Web 站 点 来 讲 ， 在 页 面 顶 部 以 用 户 








名 标示 显示 “欢迎 ”或 “您 好 ”信息 是 很 常见 的 。 这 恰恰 
是 <security:authentication> 能 为 我 们 所 做 的 事情 。 例 如 : 





Hello <security:authentication property="principal.username" />! 


其 中 ，property 用 来 标示 用 户 认 证 对 象 的 一 个 属性 。 可 用 的 属性 取决 于 
用 户 认 证 的 方式 。 但 是 ， 我 们 可 以 依赖 几 个 通用 的 属性 ， 在 不 同 的 认证 
方式 下 ， 它 们 都 是 可 用 的 ， 如 表 9.7 所 示 。 


表 9.7 使 用 <security:authentication> JSP 标 签 来 访问 用 户 的 认证 详情 


用 于 核实 月 
认证 的 附加 信息 (IP 地址、 证 件 序列 号 、 会 话 ID 等 ) 
用 户 的 基本 信息 对 象 


在 我 们 的 示例 中 ， 实 际 上 泻 染 的 是 principal 属 性 中 嵌 套 的 username 


O 










































































当 像 前 面 示例 那样 使 用 时 ，<security:authentication> 将 在 视图 中 
泻 染 属性 的 值 。 但 是 如 果 你 愿意 将 其 赋值 给 一 个 变量 ， 那 只 需要 在 var 


属性 中 指明 变量 的 名 字 即 可 。 例 如 ， 如 下 展现 了 如 何 将 其 设置 给 名 
为 loginId 的 属性 : 


<security:authentication property="principal.username" 





var="loginId"/> 


这 个 变量 默认 是 定义 在 页 面 作 用 域内 的 。 但 是 如 果 你 愿意 在 其 他 作用 域 
内 创建 它 ， 例 如 请 求 或 会 话 作 用 域 (或 者 是 能 够 

在 javax.servlet.Jjsp.PageContext 中 获取 的 其 他 作用 域 ) ， 那 么 可 
以 通过 scope 属 性 来 声明 。 例 如 ， 要 在 请 求 作 用 域内 创建 这 个 变量 ， 那 
可 以 使 用 <security:authentication> 按 照 如 下 的 方式 来 设置 : 


<security:authentication property="principal.username" 





var="loginId" scope="request" /> 


<security:authentication> 标 签 非常 有 用 ， 但 这 只 是 Spring Security 
JSP 标 签 库 功能 的 基础 功能 。 让 我 们 来 看 一 下 如 何 根 据 用 户 的 权限 来 泻 


染 内 容 。 
条 件 性 的 泻 染 内 容 


有 了 时候 视图 上 的 一 部 分 内 容 需 要 根据 用 户 被 授予 了 什么 权限 来 确定 是 否 
泻 染 。 对 于 已 经 登录 的 用 户 显 示 登 录 表 单 ， 或 者 对 还 未 登录 的 用 户 显 示 
个 性 化 的 问候 信息 部 是 无 意义 的 。 


Spring Security 的 <security:authorize>JSP 标 签 能 够 根据 用 户 被 授予 
的 权限 有 条 件 地 泻 染 页 面 的 部 分 内 容 。 例 如 ， 在 Spittr 应 用 中 ， 对 于 没 
有 ROLE_SPITTER 和 角色 的 用 户 ， 我 们 不 会 为 其 显示 添加 新 Spitter 记 录 的 
表单 。 程 序 清单 9.9 展 现 了 如 何 使 用 <security:authorize> 标 签 来 为 
具有 ROLE_SPITTER 角 色 的 用 户 显示 Spitter 表 单 。 


程序 清单 9.9 ”使 用 <security:authorize> 标 签 基 于 SpEL 进 行 有 条 件 地 泻 
染 



































局 只 有 在 具有 
全 人 和 于 ROLE SPITTER 
<sit:iorm moGGLALEr ee "SP 2 权限 时 
action ) 工 七 七 外 和 六 
上 5 二 上 h=" abel .SPit 
</sf:label 
<sf:textarea path="text' A0" /> 
<sf:errors path="text" /> 
<br/> 
<div class="spitItSubmitIt"> 
<input type="submit" value="Spit it!" 
class="status-btn round-btn disabled" /> 
</div> 
form™ 


access 属 性 被 赋值 为 一 个 SpEL 表 达 式 ， 这 个 表达 式 的 值 将 确定 
<security: authorize> 标 签 主体 内 的 内 容 是 否 泻 染 。 这 里 我 们 使 用 
了 hasRole('ROLE_SPITTER' ) 表 达 式 来 确保 用 户 上 具有 ROLE_SPITTER 
角色 。 但 是 ， 当 你 设置 access 属 性 时 ， 可 以 任意 发 挥 SpEL 的 强大 威 
力 ， 包 括 表 9.5 所 示 的 Spring Security 所 提供 的 表达 式 。 


借助 于 这 些 可 用 的 表达 式 ， 可 以 构造 出 非常 有 意思 的 安全 性 约束 。 例 
如 ， 假 设 应 用 中 有 一 些 管理 功能 只 能 对 用 户 名 为 hnabuma 的 用 户 可 用 。 
也 许 你 会 像 这 样 使 用 isAuthenticated() 和 principal 表 达 式 : 








<security:authorize 
access="isAuthenticated() and principal.username=='habuma'"> 


<a href="/admin">Administration</a> 
</security:authorize> 





我 相信 你 能 设计 出 比 这 个 更 有 意思 的 表达 式 ,可 以 尽情 发 挥 你 的 想象 力 
来 构造 更 多 的 安全 性 约束 。 借 助 于 SpEL， 选 择 其 实 是 无 限 的 。 


但 是 我 构造 的 这 个 示例 还 有 一 件 事 让 人 很 困惑 。 尽 管 我 想 限制 管理 功能 
只 能 给 habuma 用 户 ， 但 使 用 JSP 标 签 表 达 式 并 不 见得 理想 。 确 实 ， 它 能 
在 视图 上 阻止 链接 的 泻 染 。 但 是 没有 什么 可 以 阻止 别人 在 浏览 器 的 地 址 
栏 手动 输入 “/admin” 这 个 URL。 


根据 我 们 在 本 章 前 面 所 学 ， 这 和 是 一 个 很 容易 解决 的 问题 。 在 安全 配置 


中 ， 添 加 一 个 对 antMatchers () 方 法 的 调用 将 会 严格 限制 对 ”admin” 这 
个 URL 的 访问 。 


.antMatchers("/admin") 


.access("isAuthenticated() and principal.username=="'habuma'"); 





现在 ， 管 理 功能 已 经 被 锁定 了 。URL 地 址 得 到 了 保护 ， 并 且 到 这 个 URL 
的 链接 在 用 户 没 有 授权 使 用 的 情况 下 不 会 显示 。 但 是 为 了 做 到 这 一 点 ， 
我 们 需要 在 两 个 地 方 声 明 SpEL 表 达 式 一 一 在 安全 配置 中 以 及 

在 <security:authorize> 标 签 的 access 属 性 中 。 有 没有 办 法 消除 这 
并 且 还 要 确保 只 有 规则 条 件 满足 的 情况 下 才 泻 染 管理 功能 的 
连接 呢 ? 


这 是 <security:authorize> 的 url 属 性 所 要 做 的 事情 。 它 不 像 access 
属性 那样 明确 声明 安全 性 限制 ，ur1 属 性 对 一 个 给 定 的 URL 模 式 会 间接 
引用 其 安全 性 约束 。 鉴 于 我 们 已 经 在 Spring Security 配 置 中 为 “admin” 声 
明了 安全 性 约束 ， 所 以 我 们 可 以 这 样 使 用 ur1l 属 性 : 














<security:authorize url="/admin"> 
<Spring:url value="/admin" var="admin_ url" /> 


<br/><a href="${admin url}">Admin</a> 
</security:authorize> 








因为 只 有 基本 信息 中 用 户 名 为 “habuma” 的 已 认证 用 户 才 能 访问 “/admin” 
URL， 所 以 只 有 满足 以 上 条 件 ，<security:authorize> 标 签 主体 中 的 
内 容 才 会 被 演 染 。 我 们 只 在 一 个 地 方 配置 了 表达 式 〈 安 全 配置 中 ) ， 但 
是 在 两 个 地 方 进行 了 应 用 。 


Spring Security 的 JSP 标 签 库 非常 便利 ， 尤 其 是 只 给 满足 条 件 的 用 户 泻 染 
特定 的 视图 元 素 时 更 是 如 此 。 如 果 我 们 选择 Thymeleaf 而 不 是 JSP 作 为 视 
图 方案 的 话 ， 我 们 其 实 还 能 延续 这 种 好 运气 。 我 们 已 经 看 到 Thymeleaf 

的 Spring 方 言 能 够 自动 为 表单 添加 隐藏 的 CSRF token， 现 在 我 们 看 一 下 
Thymeleaf 如 何 文 持 Spring Security。 








9.5.2 ”使 用 Thymeleaf 的 Spring Security 方 言 


与 Spring Security 的 JSP 标 签 库 类 似 ，Thymeleaf 的 安全 方言 提供 了 条 件 化 
泻 染 和 显示 认证 细节 的 能 力 。 表 9.8 列 出 了 安全 方言 所 提供 的 属性 。 


表 9.8 Thymeleaf 的 安全 方言 提供 了 与 Spring Security 标 签 库 相 对 应 的 属 ; 


























府 











届 性 作 用 





演 染 认证 对 象 的 属性 。 类 似 于 Spring Security 的 


<sec:authentication/>JSP 标 签 











:authentication 











基于 表达 式 的 计算 结果 ， 条 件 性 的 演 染 内 容 。 类 似 于 Spring 
Security 的 <sec:authorize/>JSP 标 签 


:authorize 











基于 表达 式 的 计算 结果 ， 条 件 性 的 泻 染 内 容 。 类 似 于 Spring 





:authorize-acl : 一 
Security 的 <sec:accesscontrollist/> JSP 标 签 


:authorize-expr | sec:authorize 属 性 的 别名 














基于 给 定 URL 路 径 相 关 的 安全 规则 ， 条 件 性 的 演 染 内 容 。 类 似 于 
Spring Security 的 <sec:authorize/> JSP 标 签 使 用 url 属 性 时 的 场景 


:authorize-url 























为 了 使 用 安全 方言 ， 我 们 需要 确保 Thymeleaf Extras Spring Security 已 经 
位 于 应 用 的 类 路 径 下 。 然 后 ， 还 需要 在 配置 中 使 

用 SpringTemp1lateEngine 来 注册 springSsecurity Dialect。 程 序 清 
单 9.10 所 展现 的 @Bean 方 法 声明 了 SpringTemplateEngine bean， 其 

中 就 包含 了 SpringSecurityDialect。 


程序 清单 9.10 注册 Thymeleaf 的 Spring Security 安 全 方言 


public SpringTemplateEngine Sak Enginei 


lateResolver templateResolver) { 





ringTemplateEngine templateEngin new SpringTemplateEngine!(); 







ateEngine.setTemplateResolver(templateResolver); 

ateEngine.addDialect (new SpringSecurityDialect{()); 注册 
return templateEngine; A 
女 全 方言 


安全 方言 注册 完成 之 后 ， 我 们 就 可 以 在 Thymeleaf 模 板 中 使 用 它 的 属性 
了 。 首 先 ， 需 要 在 使 用 这 些 属性 的 模板 中 声明 安全 命名 空间 : 





<“!DOCTYPE html> 


<html xmlns="http://www.w3.org/1999/xhtml" 
xmlns:th="http://www.thymeleaf .org" 
xmlns:sec= 
"http://www.thymeleaf.org/thymeleaf-extras-springsecurity3"> 


在 这 里 ， 标 准 的 Thymeleaf 方 法 依旧 与 之 前 一 样 ， 使 用 th 前 级 ， 安 全 方 
言 则 设置 为 使 用 sec 前 级 。 


这 样 我 们 就 能 在 任意 合适 的 地 方 使 用 Thymeleaf 属 性 了 。 比 如 ， 假 设 我 
们 想 要 为 认证 用 户 泻 染 “Hello” 文 本 。 如 下 的 Thymeleaf 模 板 代 码 片 段 就 
能 完成 这 项 任务 : 


<div sec:authorize="isAuthenticated()"> 


Hello <span sec:authentication="name">someone</span> 
</div> 





sec:authorize 属 性 会 接受 一 个 SpEL 表 达 式 。 如 果 表 达 式 的 计算 结果 
为 true， 那 么 元 素 的 主体 内 容 就 会 泻 染 。 在 本 例 中 ， 表 达 式 

为 isAuthenticated()， 所 以 只 有 用 户 已 经 进行 了 认证 ， 才 会 泻 染 
<div> 标 签 的 主体 内 容 。 就 这 个 标签 的 主体 内 容 部 分 而 言 ， 它 的 功能 是 
使 用 认证 对 象 的 name 属 性 提示 “Hello” 文 本 。 


你 可 能 还 记得 ， 在 Spring Security 中 ， 借 助 <sec:authorize>JSP 标 签 的 
url 属 性 能 够 基于 给 定 URL 的 权限 有 条 件 地 泻 染 内 容 。 在 Thymeleaf 中 ， 
我 们 可 以 通过 sec:authorize-url 属 性 完成 相同 的 功能 。 例 如 ， 如 下 
Thymeleaf 代 码 片 段 所 实现 的 功能 与 之 前 <sec:authorize> JSP 标 签 和 
url 属 性 所 实现 的 功能 是 相同 的 : 








<span sec:authorize-url="/admin"> 


<br/><a th:href="@{/admin}">Admin</a> 
</span> 





如 果 用 户 有 权限 访问 “%admin” 的 话 ， 那 么 到 管理 页 面 的 链接 就 会 泻 染 ， 
否则 的 话 ， 这 个 链接 将 不 会 泻 染 。 


9.6 ”小结 


对 于 许多 应 用 而 言 ， 安 全 性 都 是 非常 重要 的 切面 。Spring Security 提 供 
了 一 种 简单 、 灵 活 且 强大 的 机 制 来 保护 我 们 的 应 用 程序 。 


借助 于 一 系列 Servlet Filter，Spring Security 能 够 控制 对 Web 资 源 的 访 
问 ， 包 括 Spring MVC 控 制 器 。 借 助 于 Spring Security 的 Java 配 置 模型 ， 
我 们 不 必 直 接 处 理 Filter， 能 够 非常 简洁 地 声明 Web 安 全 性 功能 。 


当 认 证 用 户 时 ，Spring Security 提 供 了 多 种 选项 。 我 们 探讨 了 如 何 基于 
内 存 用 户 库 、 关 系 型 数据 库 和 LDAP 目 录 服 务 器 来 配置 认证 功能 。 如 果 
这 些 可 选 方案 无 法 满足 认证 需求 的 话 ， 我 们 还 学 习 了 如 何 创 建 和 配置 目 
定义 的 用 户 服务 。 

在 前 面 的 几 章 中 ， 我 们 看 到 了 如 何 将 Spring 运用 到 应 用 程序 的 前 端 。 在 


接 下 来 的 章 中 ， 我 们 将 会 继续 深入 这 个 技术 栈 ， 学 习 Spring 如 何在 后 端 
发 挥 作 用 ， 下 一 章 将 会 首先 从 Spring 的 JDBC 抽 象 开始 。 








第 3 部 分 “后 痛 中 的 Spring 


尽管 用 户 看 到 的 内 容 是 由 Web 应 用 所 提供 的 页 面 ， 但 是 在 这 背后 ， 实 际 
的 工作 是 在 后 端 服务 器 中 发 生 的 ， 在 这 里 会 处 理 和 持久 化 数据 。 第 3 部 
分 将 会 天 注 Spring 如 何 帮 助 我 们 在 后 端 处 理 数 据 。 


多 年 以 来 ， 关 系 型 数据 库 一 直 是 企业 级 应 用 中 的 统治 者 。 在 第 10 章 “ 通 
过 Spring 和 JDBC 征 服 数 据 库 ? 中 ， 我 们 将 会 看 到 如 何 使 用 Spring 的 JDBC 
抽象 来 查询 关系 型 数据 库 ， 这 要 比 原 生 的 JDBC 简 单 得 多 。 


如 果 你 不 喜欢 JDBC 风 格 的 话 ， 在 第 11 章 “通过 对 象 -关系 映射 持久 化 数 
据 ” 中 ， 将 会 展现 如 何 与 ORM 框 架 进 行 集成 ， 这 些 框架 包括 Hibernate 以 
及 其 他 的 Java 持 久 化 API (Java Persistence API，JPA) 实现 。 除 此 之 
外 ， 还 将 会 看 到 如 何 发 挥 Spring Data JPA 的 魔力 ， 在 运行 时 自动 生成 
Repository 实 现 。 


关系 型 数据 库 不 一 定 是 所 有 场景 下 的 最 佳 选择 ， 因 此 ， 第 12 章 “使 用 
NoSQL 数 据 库 ” 将 会 研究 其 他 的 Spring Data 项 目 ， 它 们 能 够 持久 化 各 种 
非 关 系 型 数据 库 中 的 数据 ， 包 括 MongoDB、Neo4j 和 Redis 。 


第 13 章 “缓存 数据 ?为 上 述 的 持久 化 章 提 供 了 一 个 缓存 层 ， 如 果 数 据 已 经 
可 用 的 话 ， 它 会 避免 数据 库 操作 ， 从 而 提升 应 用 的 性 能 。 


与 前 端 类 似 ， 安 全 性 在 后 端 也 是 一 个 很 重要 的 方面 。 在 第 14 音 “保护 方 
法 应 用 ”中 ， 将 会 把 Spring Security 应 用 于 后 端 ， 它 会 拦截 方法 的 调用 并 
确保 调用 者 被 授予 了 适当 的 权限 。 




















第 10 章 ”通过 Spring 和 JDBC 征 服 
数据 库 


本 章 内 容 : 


。 定义 Spring 对 数据 访问 的 文 持 
。 配置 数据 库 资 源 
。 使 用 Spring 的 JDBC 模 版 


在 掌握 了 Spring 容器 的 核心 知识 之 后 ， 是 时 候 将 它 在 实际 应 用 中 进行 使 
用 了 。 数 据 持 久 化 是 一 个 非常 不 错 的 起 点 ， 因 为 几乎 所 有 的 企业 级 应 用 
程序 中 都 存在 这 样 的 需求 。 我 们 可 能 都 处 理 过 数据 库 访问 功能 ， 在 实际 
的 工作 中 也 发 现 数据 访问 有 一 些 不 足 之 处 。 我 们 必须 初始 化 数据 访问 杠 
架 、 打 开 连 接 、 处 理 各 种 异常 和 关闭 连接 。 如 果 上 述 操作 出 现任 何 问 

题 ， 都 有 可 能 损坏 或 删除 珍贵 的 企业 数据 。 如 果 你 还 未 曾经 历 过 因 未 有 
善 处 理 数据 访问 而 带 来 的 严重 后 果 ， 那 我 要 提醒 你 这 绝对 不 是 什么 好 事 


二 


做 事 要 追求 尽善尽美 ， 所 以 我 们 选择 了 Spring。Spring 目 带 了 一 组 数据 

访问 框架 ， 集 成 了 多 种 数据 访问 技术 。 不 管 你 是 直接 通过 JDBC 还 是 像 
Hibernate 这 样 的 对 象 关 系 映 射 (object-relational mapping，ORM) 框架 
实现 数据 持久 化 ，Spring 都 能 够 帮 你 消除 持久 化 代码 中 那些 单调 枯燥 的 
数据 访问 逻辑 。 我 们 可 以 依赖 Spring 来 处 理 底层 的 数据 访问 ， 这 样 就 可 
以 专注 于 应 用 程序 中 数据 的 管理 了 。 


当 开 发 Spittr 应 用 的 持久 层 的 时 候 ， 会 面临 多 种 选择 ， 我 们 可 以 使 用 
JDBC、Hibernate、Java 持 久 化 API (Java Persistence API，JPA) 或 者 其 
他 任意 的 持久 化 框架 。 你 可 能 还 会 考虑 使 用 最 近 很 流行 的 NoSQL 数 据 库 
(其 实 我 更 喜欢 将 其 称 为 无 模式 数据 库 ) 。 


幸好 ， 不 管 你 选择 哪 种 持久 化 方式 ，Spring 都 能 够 提供 文 持 。 在 本 章 ， 
我 们 主要 关注 于 Spring 对 JDBC 的 文 持 。 但 首先 ， 我 们 来 熟悉 一 下 Spring 
的 持久 化 哲学 ， 从 而 为 后 面 打 好 基础 。 

















10.1 Spring 的 数据 访问 哲学 


从 前 面 的 几 半 可 以 看 出 ，Spring 的 目标 之 一 就 是 允许 我 们 在 开发 应 用 程 
序 时 ， 能 够 遵循 面 辐 对 象 “O00) 原则 中 的 “针对 接口 编程 "。Spring 对 数 
据 访 问 的 支持 也 不 例外 。 


像 很 多 应 用 程序 一 样 ，Spittr 应 用 需要 从 茶 种 类 型 的 数据 库 中 读 取 和 号 
入 数据 。 为 了 避免 持久 化 的 逻辑 分 散 到 应 用 的 各 个 组 件 中 ， 最 好 将 数据 
访问 的 功能 放 到 一 个 或 多 个 专注 于 此 项 任务 的 组 件 中 。 这 样 的 组 件 通 第 
称 为 数据 访问 对 象 (data access object，DAO ) 或 Repository。 


为 了 避免 应 用 与 特定 的 数据 访问 策略 耦合 在 一 起 ， 编 写 展 好 的 
Repository 应 该 以 接口 的 方式 暴露 功能 。 图 10.1 展 现 了 设计 数据 访问 层 的 


合理 方式 。 
Repository 
接口 






















Repository 
实现 




















图 10.1 服务 对 象 本 身 并 不 会 处 理 数据 访问 ， 而 是 将 数据 访问 委托 给 Repository。 
Repository 接 口 确保 其 与 服务 对 象 的 松 耘 合 


如 图 所 示 ， 服 务 对 象 通 过 接口 来 访问 Repository。 这 样 做 会 有 几 个 好 

处 。 第 一 ， 它 使 得 服务 对 象 易 于 测试 ， 因 为 它们 不 再 与 特定 的 数据 访问 
实现 绑 定 在 一 起 。 实 际 上 ， 你 可 以 为 这 些 数 据 访 问 接口 创建 mock 实 
现 ， 这 样 无 需 连接 数据 库 就 能 测试 服务 对 象 ， 而 且 会 显著 提升 单元 测试 
的 效率 并 排除 因数 据 不 一 致 所 造成 的 测试 失败 。 


此 外 ， 数 据 访问 层 是 以 持久 化 技术 无 关 的 方式 来 进行 访问 的 。 持 和 久 化 方 
式 的 选择 独立 于 Repository， 同 时 只 有 数据 访问 相关 的 方法 才 通 过 接口 

进行 暴露。 这 可 以 实现 灵活 的 设计 ， 并 且 切 换 持 久 化 框架 对 应 用 程序 其 
他 部 分 所 带 来 的 影响 最 小 。 如 果 将 数据 访问 层 的 实现 细节 渗透 到 应 用 程 
































序 的 其 他 部 分 中 ， 那 么 整个 应 用 程序 将 与 数据 访问 层 精 合 在 一 起 ， 从 而 
导致 僵化 的 设计 。 


接口 与 Spring: 如 果 在 阅读 了 上 面 几 段 文字 之 后 ， 你 能 感受 到 我 倾 问 于 

将 持久 层 隐藏 在 接口 之 后 ， 那 很 高 兴 我 的 目的 达到 了 。 我 相信 接口 是 实 
现 松 耦合 代码 的 关键 ， 并 且 应 将 其 用 于 应 用 程序 的 各 个 层 ， 而 不 仅仅 是 
持久 化 层 。 还 要 说 明 一 点 ， 尽 管 Spring 鼓励 使 用 接口 ， 但 这 并 不 是 强制 

的 你 可 以 使 用 Spring 将 bean (DAO 或 其 他 类 型 ) 直接 装配 到 另 一 个 

bean 的 某 个 属性 中 ， 而 不 需要 一 定 通过 接口 注入 。 


为 了 将 数据 访问 层 与 应 用 程序 的 其 他 部 分 隅 离开 来 ，Spring 采 用 的 方式 
人 这 个 异常 体系 用 在 了 它 文 持 的 所 有 持久 
方案 中 。 


10.1.1 了 解 Spring 的 数据 访问 异常 体系 


这 里 有 一 个 关于 跳伞 运动 员 的 经 典 笑 话 ， 这 个 运动 员 被 风 吹 离 正 常 路 线 
后 降落 在 树 上 并 高 高 地 挂 在 那里 。 后 来 ， 有 人 路 过 ， 跳 伞 运 动员 就 问 他 
自己 在 什么 地 方 。 过 路 人 回答 说 :“ 你 在 离 地 大 约 20 尺 的 空中 。” 跳 命运 
动员 说 :“ 你 一 定 是 个 软件 分 析 师 。” 过 路 人 回应 说 “你 说 对 了 。 你 是 怎 
么 知道 的 呢 ? 基因 为 你 跟 我 说 的 话 百 分 百 正 确 ， 但 丝 坚 用 处 都 没有 。?” 


这 个 故事 已 经 听 过 很 多 过 了 ， 每 次 过 路 人 的 职业 或 国籍 都 会 有 所 不 同 。 
但 是 这 个 故事 使 我 想起 了 JDBC 中 的 SQLException。 如 果 你 曾经 编写 过 
JDBC 代 码 〈 不 使 用 Spring) ， 你 肯定 会 意识 到 如 果 不 强 制 捕获 
SQLException 的 话 ， 几 乎 无 法 使 用 JDBC 做 任何 事情 。SQLException 
表示 在 尝试 访问 数据 库 的 时 出 现 了 问题 ， 但 是 这 个 异常 却 没 有 告诉 你 哪 
里 出 错 了 以 及 如 何 进 行 处 理 。 


可 能 导致 抛 出 SQLException 的 常见 问题 包括 ; 


应 用 程序 无 法 连接 数据 库 ; 

要 执行 的 查询 存在 语法 错误 ; 

查询 中 所 使 用 的 表 和 /或 列 不 存在 ; 

试图 插入 或 更 新 的 数据 违反 了 数据 库 约束 。 


SQLException 的 问题 在 于 捕获 到 它 的 时 候 该 如 何 处 理 。 事 实 上 ， 能 够 
触发 SQLException 的 问题 通常 是 不 能 在 catch 代 码 块 中 解决 的 。 大 多 数 












































抛 出 SQLException 的 情况 表明 发 生 了 致命 性 错误 。 如 果 应 用 程序 不 能 
连接 到 数据 库 ， 这 通常 意味 着 应 用 不 能 继续 使 用 了 。 类 似 地 ， 如 果 查 询 
时 出 现 了 错误 ， 那 在 运行 时 基本 上 也 是 无 能 为 力 。 


如 果 无 法 从 SQLException 中 恢复 ， 那 为 什么 我 们 还 要 强制 捕获 它 呢 ? 


即使 对 某 些 SQLException 有 处 理 方案 ， 我 们 还 是 要 捕获 SQLEXxception 
并 查看 其 属性 才能 获知 问题 根源 的 更 多 信息 。 这 是 因为 SQLException 
被 视 为 处 理 数据 访问 所 有 问题 的 通用 异常 。 对 于 所 有 的 数据 访问 问题 都 
会 抛 出 SQLException， 而 不 是 对 每 种 可 能 的 问题 都 会 有 不 同 的 异常 类 


型 














一 些 持 久 化 框架 提供 了 相对 丰富 的 寞 常 体系 。 例 如 ，Hibernate 提 供 了 二 
十 个 左右 的 异常 ， 分 别 对 应 于 特定 的 数据 访问 问题 。 这 样 就 可 以 针对 想 
处 理 的 异常 编写 catch 代 码 块 。 


即便 如 此 ，Hibernate 的 异常 是 其 本 身 所 特有 的 。 正 如 前 面 所 言 ， 我 们 想 
将 特定 的 持久 化 机 制 独立 于 数据 访问 层 。 如 果 抛 出 了 Hibernate 所 特有 的 
异常 ， 那 我 们 对 Hibernate 的 使 用 将 会 渗透 到 应 用 程序 的 其 他 部 分 。 如 果 
不 这 样 做 的 话 ， 我 们 就 得 捕获 持久 化 平台 的 异常 ， 然 后 将 其 作为 平台 无 
关 的 异常 再 次 抛 出 。 


一 方面 ，JDBC 的 异常 体系 过 于 简单 了 守卫 思量 不 上 二 全 体 
系 。 另 一 方面 ，Hibernate 的 异 稼 体系 是 其 本 身 所 独 有 的 。 我 们 需要 的 数 
据 访 问 异 党 要 具有 描述 性 而 且 又 与 特定 的 持久 化 框架 无 关 。 


Spring 所 提供 的 平台 无 天 的 持久 化 异常 
Spring JDBC 提 供 的 数据 访问 异常 体系 解决 了 以 上 的 两 个 问题 。 不 同 于 


JDBC，Spring 提 供 了 多 个 数据 访问 异常 ， 分 别 描述 了 它们 抛 出 时 所 对 应 
的 问题 。 表 10.1 对 比 了 Spring 的 部 分 数据 访问 异常 以 及 JDBC 所 提供 的 异 
常 。 

















从 表 中 可 以 看 出 ，Spring 为 读 取 和 写 入 数据 库 的 几乎 所 有 错误 都 提供 了 
异常 。Spring 的 数据 访问 异常 要 比 表 10.1 所 列 的 还 要 多 。 在 此 没有 列 
出 所 有 的 异常 ， 因 为 我 不 想 让 JDBC 显 得 太 寒酸 。) 


表 10.1 JDBC 的 异常 体系 与 Spring 的 数据 访问 异常 











SR 


BadSsqlGrammarException 
CannotAcquireLockException 
CannotSerializeTransactionException 
CannotGetJdbcConnectionException 
CleanupFailureDataAccessException 
ConcurrencyFailureException 
DataAccessException 
DataAccessResourceFailureException 
DataIntegrityViolationException 
DataRetrievalFailureException 
DataSourceLookupApiUsageException 
DeadlockLoserDataAccessException 
DuplicateKeyException 
EmptyResultDataAccessException 
IncorrectResultSizeDataAccessException 
IncorrectUpdateSsemanticsDataAccessException 
InvalidDataAccessApiUsageException 
InvalidDataAccessResourceUsageException 
InvalidResultSetAccessException 
JdbcUpdateAffectedIncorrectNumberOfRowsException 
LbRetrievalFailureException 


BatchUpdateException 
DataTruncation 
SQLException 
SQLWarning 


NonTransientDataAccessResourceException 
OptimisticLockingFailureException 
PermissionDeniedDataAccessException 
PessimisticLockingFailureException 
QueryTimeoutException 
RecoverableDataAccessException 
SQLWarningException 
SqlXmlFeatureNotImplementedException 
TransientDataAccessException 
TransientDataAccessResourceException 
TypeMismatchDataAccessException 
UncategorizedDataAccessException 
UncategorizedSQLException 


BatchUpdateException 
DataTruncation 
SQLException 
SQLWarning 





尽管 Spring 的 异常 体系 比 JDBC 简 单 的 SQLException 丰 富 得 多 ， 但 它 并 
没有 与 特定 的 持久 化 方式 相关 联 。 这 意味 着 我 们 可 以 使 用 Spring 抛 出 一 
致 的 异常 ， 而 不 用 关心 所 选择 的 持久 化 方案。 这 有 助 于 我 们 将 所 选择 持 
久 化 机 制 与 数据 访问 层 阳 离开 来 。 


看 ! 不 用 写 catch 代 码 块 


表 10.1 中 没有 体现 出 来 的 一 点 就 是 这 些 异 党 都 继承 自 
DataAccessException。DataAccessException 的 特殊 之 处 在 于 它 是 
一 个 非 检查 型 异常 。 换 人 句 话说 ， 没 有 必要 捕获 Spring 所 抛 出 的 数据 访问 
异常 (当然 ， 如 有 果 你 想 捕获 的 话 也 是 完全 可 以 的 ) 。 


DataAccessException 只 是 Sping 处 理 检 查 型 异常 和 非 检查 型 异常 哲学 
的 一 个 范例 。Spring 认 为 触发 异常 的 很 多 问题 是 不 能 在 catch 代 码 块 中 














修复 的 。Spring 使 用 了 非 检 查 型 异常 ， 而 不 是 强制 开发 人 员 编 写 catch 
代码 块 《 里 面 经 芝 是 空 的 ) 。 这 把 是 合 要 捕获 异常 的 权力 留 给 了 开发 人 


员 。 


为 了 利用 Spring 的 数据 访问 腊 常 ， 我 们 必须 使 用 Spring 所 支持 的 数据 访 
问 模 板 。 让 我 们 看 一 下 Spring 的 模板 是 如 何 简化 数据 访问 的 。 


10.1.2 ”数据 访问 模板 化 


如 末 以 前 有 搭乘 飞机 旅行 的 经 历 ， 你 肯定 会 党 得 旅行 中 很 重要 的 一 件 事 
就 是 将 行李 从 一 个 地 方 搬运 到 另 一 个 地 方 。 这 个 过 程 包含 多 个 步骤 。 当 
你 到 达 机 场 时 ， 第 一 站 是 到 柜台 办 理 行 李 托运 。 然 后 保安 人 员 对 其 进行 
安检 以 确保 安全 。 之 后 行李 将 通过 行李 车 转送 到 飞机 上 。 如 果 你 需要 中 
途 转机 ， 行 李 也 要 进行 中 转 。 当 你 到 达 目 的 地 的 时 候 ， 行 李 需 要 从 飞机 
上 取 下 来 并 放 到 传送 带 上 。 最 后 ， 你 到 行李 认领 区 将 其 取 回 。 


尽管 在 这 个 过 程 中 包含 多 个 步骤 ， 但 是 涉及 到 旅客 的 只 有 几 个 。 承 运 人 
负责 推动 整个 流程 。 你 只 会 在 必要 的 时 候 进 行 参与 ， 其 余 的 过 程 不 必 关 
心 。 这 反映 了 一 个 强大 的 设计 模式 ， 模 板 方法 模式 。 


模板 方法 定义 过 程 的 主要 框架 。 在 我 们 的 示例 中 ， 整 个 过 程 是 将 行李 从 
出 发 地 运送 到 目的 地 。 过 程 本 身 是 固定 不 变 的 。 处 理 行李 过 程 中 的 每 个 
事件 都 会 以 同样 的 方式 进行 : 托运 检查 、 运 送 到 飞机 上 等 等 。 在 这 个 过 
程 中 的 茶 些 步骤 是 固定 的 一 一 这 些 步 骤 每 次 都 是 一 样 的 。 比 如 当 飞 机 到 
达 目 的 地 后 ， 所 有 的 行李 被 取 下 来 并 通过 传送 带 运 到 取 行 李 处 。 


在 茶 些 特定 的 步骤 上 ， 处 理 过 程 会 将 其 工作 委 小 给 子 类 来 完成 一 些 特定 
实现 的 细节 。 这 是 过 程 中 变化 的 部 分 。 例 如 ， 处 理 行李 是 从 乘客 在 柜台 
托运 行李 开始 的 。 这 部 分 的 处 理 往往 是 在 最 开始 的 时 候 进行 ， 所 以 它 在 
处 理 过 程 中 的 顺序 是 固定 的 。 由 于 每 位 乘客 的 行李 登记 都 不 一 样 ， 所 以 
这 个 过 程 的 实现 是 由 旅客 决定 的 。 按 照 软 件 方 面 的 术语 来 讲 ， 模 板 方 法 
将 过 程 中 与 特定 实现 相关 的 部 分 委托 给 接口 ， 而 这 个 接口 的 不 同 实现 定 
义 了 过 程 中 的 具体 行为 。 


这 也 是 Spring 在 数据 访问 中 所 使 用 的 模式 。 不 管 我 们 使 用 什么 样 的 技 

术 ， 都 需要 一 些 特 定 的 数据 访问 步骤 。 例 如， 我 们 都 需要 获取 一 个 到 数 
据 存 储 的 连接 并 在 处 理 完 成 后 释放 资源 。 这 都 是 在 数据 访问 处 理 过 程 中 
的 固定 步 又， 但 是 每 种 数据 访问 方法 又 会 有 些 不 同 ， 我 们 会 查询 不 同 的 












































对 象 或 以 不 同 的 方式 更 新 数据 ， 这 都 是 数据 访问 过 程 中 变化 的 部 分 。 


Spring 将 数据 访问 过 程 中 固定 的 和 可 变 的 部 分 明确 划分 为 两 个 不 同 的 
类 : 模板 (template) 和 回调 (callback) 。 模 板 管理 过 程 中 国定 的 部 
分 ， 而 回调 处 理 自 定义 的 数据 访问 代码 。 图 10.2 展 现 了 这 两 个 类 的 职 
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Repository 模 板 Repository 回 调 


3. 在 事务 中 执行 








5. 提交 / 回 深 事 务 
6. 关闭 资源 和 处 理 
错误 





























图 10.2 ”Spring 的 数据 访问 模板 类 负责 通用 的 数据 访问 功能 。 对 于 应 用 程序 
特定 的 任务 ， 则 会 调用 自 定 义 的 回调 对 象 


如 图 所 示 ，Spring 的 模板 类 处 理 数 据 访问 的 固定 部 分 
理 资 源 以 及 处 理 寞 第 。 同 时 ， 应 用 程序 相关 的 数据 访问 











事务 控制 、 








语句 、 绑 定 


参数 以 及 整理 结果 集 一 一 在 回调 的 实现 中 处 理 。 事 实证 明 ， 这 是 一 个 优 


雅 的 架构 ， 因 为 你 只 需 关 心 自己 的 数据 访问 逻辑 即 可 。 
针对 不 同 的 持久 化 平台 ，Spring 提 供 了 多 个 可 选 的 模板 。 如 果 和 直接 使 用 


JDBC， 那 你 可 以 选择 JdbcTemplate。 如 果 你 希望 使 用 对 象 关 系 映射 框 
架 ， 那 HibernateTemplate 或 JjpaTemplate 可 能 会 更 适合 你 。 表 10.2 列 


出 了 Spring 所 提供 的 所 有 数据 访问 模板 及 其 用 途 。 
表 10.2 ”Spring 提供 的 数据 访问 模板 ， 分 别 适 用 于 不 同 的 持久 化 机 制 


模板 类 (org.springframework.*) 用 途 








jdbc.core.namedparam.NamedParameterJdbcTemplate 支持 命名 参数 的 JDBC 连 接 





jdbc.core.simple.SimpleJdbcTemplate 通过 Java 化 后 的 JDBC 连 接 
(Spring 3.1 中 已 经 废弃 ) 


orm.hibernate3.HibernateTemplate Hibernate 3.x 以 上 的 Session 











orm.ibatis.SqlMapClientTemplate iBATIS SqlMap 客 户 端 


Java 数 据 对 象 〈Java Data Object ) 
实现 


Spring 为 多 种 持久 化 框 淋 提供 了 文 持 ， 这 里 没有 那么 多 的 篇 幅 在 本 章 对 
其 进行 一 一 介绍 。 因 此 ， 我 会 关注 于 我 认为 最 为 实用 的 持久 化 方案 ， 这 
也 是 读者 最 可 能 用 到 的 。 


在 本 章 中 ， 我 们 将 会 从 基础 的 JDBC 访 问 开 始 ， 因 为 这 是 从 数据 库 中 读 
取 和 写 入 数据 的 最 基本 方式 。 在 第 11 章 中 ， 我 们 将 会 了 解 Hibernate 和 
JPA， 这 是 最 流行 的 基于 POJO 的 ORM 方 案 。 我 们 会 在 第 12 章 结束 Spring 
持久 化 的 话题 ， 在 这 一 章 中 ， 将 会 看 到 Spring Data 项 目 是 如 何 让 Spring 
文 持 无 模式 数据 的 。 


但 首先 要 说 明 的 是 Spring 所 文 持 的 大 多 数 持久 化 功能 都 依赖 于 数据 源 。 
因此 ， 在 声明 模板 和 Repository 之 前 ， 我 们 需要 在 Spring 中 配置 一 个 数据 
源 用 来 连接 数据 库 。 





orm.jdo.JdoTemplate 






































10.2 ”配置 数据 源 


无 论 选择 Spring 的 哪 种 数据 访问 方式 ， 你 都 需要 配置 一 个 数据 源 的 引 
。Spring 提 供 了 在 Spring 上 下 文中 配置 数据 源 bean 的 多 种 方式 ， 包 
舌 : 


。 通过 JDBC 了 驱动 程序 定义 的 数据 源 ; 
。 通过 JNDI 查 找 的 数据 源 ; 
。 连接 池 的 数据 源 。 


对 于 即将 发 布 到 生产 环境 中 的 应 用 程序 ， 我 建议 使 用 从 连接 池 获 取 连 接 
的 数据 源 。 如 果 可 能 的 话 ， 我 倾 回 于 通过 应 用 服务 器 的 JNDI 来 获取 数据 
. 请 记 住 这 一 点 ， 让 我 们 首先 看 一 下 如 何 配置 Spring 从 JNDI 中 获取 数 
电源 。 


10.2.1 使 用 JNDI 数 据 源 


Spring 应 用 程序 经 稼 部署 在 Java EE 应 用 服务 器 中 ， 如 WebSphere、JBoss 
或 其 至 像 Tomcat 这 样 的 Web 容 器 中 。 这 些 服务 占 人 允许 你 配置 通过 JNDI 获 
取 数 据 源 。 这 种 配置 的 好 处 在 于 数据 源 完全 可 以 在 应 用 程序 之 外 进行 管 
理 ， 这 样 应 用 程序 只 需 在 访问 数据 库 的 时 候 查 找 数据 源 就 可 以 了 。 男 
外 ， 在 应 用 服务 器 中 管理 的 数据 源 通常 以 池 的 方式 组 织 ， 从 而 具备 更 好 
的 性 能 ， 并 且 还 文 持 系统 管理 员 对 其 进行 热切 换 。 


利用 Spring， 我 们 可 以 像 使 用 Spring bean 那 样 配 置 JNDI 中 数据 源 的 引用 
并 将 其 装配 到 需要 的 类 中 。 位 于 jee 命 名 空间 下 的 <jee:jndi-lookup> 
元 素 可 以 用 于 检索 JNDI 中 的 任何 对 象 ( 包 括 数据 源 ) 并 将 其 作为 Spring 
的 bean。 例 如 ， 如 果 应 用 程序 的 数据 源 配 置 在 JINDI 中 ， 我 们 可 以 使 

用 <jee:jndi-lookup> 元 素 将 其 装配 到 Spring 中 ， 如 下 所 示 : 











<jee:jndi-lookup id="dataSource" 


jndi-name="/jdbc/SpitterDS" 
resource-ref="true" /> 





其 中 jndi-name 属 性 用 于 指定 JNDI 中 资源 的 名 称 。 如 果 只 设置 了 jndi- 
name 属 性 ， 那 么 就 会 根据 指定 的 名 称 查找 数据 源 。 但 是 ， 如 果 应 用 程序 





运行 在 Java 应 用 服务 器 中 ， 你 需要 将 resource-ref 属 性 设置 为 true， 
这 样 给 定 的 jndi-name 将 会 自动 添加 “java:comp/env/” 前 级 。 


如 果 想 使 用 Java 配 置 的 话 ， 那 我 们 可 以 借助 JndiobjectFactoryBean 
从 JNDI 中 查找 DataSource: 


@Bean 

public JndiobJjectFactoryBean dataSource() { 
JndiobJjectFactoryBean jndiObjectFB = new JndiobJjectFactoryBean( ) ; 
jndiObjectFB.setJndiName("jdbc/SpittrDS"); 


jndiObjectFB.setResourceRef(true); 
jndiObjectFB.setProxyInterface(javax.sql.DataSource.class); 
return jndiObjectFB; 





显然 ， 通 过 Java 配 置 获 取 JNDI bean 要 更 为 复杂 。 大 多 数 情 况 下 ，Java 配 
置 要 比 XML 配 置 简 单 ， 但 是 这 一 次 我 们 需要 写 更 多 的 Java 人 代码。 但 是 ， 
很 容易 就 能 够 看 出 Java 代 码 中 与 XML 相对 应 的 配置 ，Java 配 置 的 内 容 其 
实 也 不 算 多 。 


10.2.2 ”使 用 数据 源 连 接 池 
如 果 你 不 能 从 JNDI 中 查找 数据 源 ， 那 么 下 一 个 选择 就 是 直接 在 Spring 中 


配置 数据 源 连 接 池 。 尽 管 Spring 并 没有 提供 数据 源 连 接 池 实 现 ， 但 是 我 
们 有 多 项 可 用 的 方案 ， 包 括 如 下 开源 的 实现 : 





。 Apache Commons DBCP (http:/jakarta.apache.org/commons/dbcp); 
e c3p0 (http://sourceforge.net/projects/c3p0/) ; 
e BoneCP (http://jolbox.com/) 。 


这 些 连接 池 中 的 大 多 数 都 能 配置 为 Spring 的 数据 源 ， 在 一 定 程 度 上 与 
Spring 自 带 的 DriverManagerDataSource 

或 SingleConnectionDataSource 很 类 似 〈 我 们 稍 后 会 对 其 进行 介 
绍 ) 。 例 如 ， 如 下 就 是 配置 DBCP BasicDataSource 的 方式 : 





<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" 
p:driverClassName="org.h2.Driver" 
p:url="jdbc:h2:tcp://localhost/~/spitter" 
p:username="sa" 
p:password="" 


p:initialSize="5" 
p:maxActive="160" /> 





如 果 你 喜欢 Java 配 置 的 话 ， 连 接 池 形式 的 DataSourcebean 可 以 声明 如 
下 : 


@Bean 

public BasicDataSource dataSource() { 
BasicDataSource ds = new BasicDataSource(); 
ds.setDriverClassName("org.h2.Driver"); 
ds.setUrl("jdbc:h2:tcp://localhost/~/spitter"); 
ds.setUsername("sa"); 

ds.setpassword(""); 

ds.setInitialSize(5); 

ds.setMaxActive(10); 

return ds; 





前 四 个 属性 是 配置 BasicDataSource 所 必需 的 。 属 

性 driverClassName 指 定 了 JDBC 了 驱动 类 的 全 限定 类 名 。 在 这 里 我 们 配 
置 的 是 H2 数 据 库 的 数据 源 。 属 性 ur1l 用 于 设置 数据 库 的 JDBC URL。 最 
后 ，username 和 password 用 于 在 连接 数据 库 时 进行 认证 。 


以 上 四 个 基本 属性 定义 了 BasicDataSsource 的 连接 信息 。 除 此 以 外 ， 
还 有 多 个 配置 数据 源 连 接 池 的 属性 。 表 10.3 列 出 了 DBCP 
BasicDataSource 最 有 用 的 一 些 池 配 置 属性 : 


表 10.3 BasicDataSource 的 池 配 置 属性 


所 指定 的 内 容 
池 启 动 时 创建 的 连接 数量 


同一 时 间 可 从 池 中 分 配 的 最 多 连接 数 。 如 果 设 置 为 0%， 表 
示 无 限制 





























maxActive 





0 如 果 设 置 为 0%， 表 示 
限 利 
































maxOpenPreparedSstatements 在 同一 时 间 能 够 从 语句 池 中 分 配 的 预 处 理 语句 re 
statement) 的 最 大 数量 。 如 果 设 置 为 0， 表 示 无 限制 














在 抛 出 异常 之 前 ， 池 等 待 连接 回收 的 最 大 时 间 ( 当 没有 
可 用 连接 时 ) 。 如 果 设 置 为 -1， 表 示 无 限 等 待 


minEvictableIdleTimeMillis | 连接 在 池 中 保持 空 闪 而 不 被 回收 的 最 大 时 间 



































在 不 创建 新 连接 的 情况 下 ， 池 中 保持 空闲 的 最 小 连接 数 








人 是 否 对 预 处 理 语句 〈prepared statement) 进行 池 管 理 〈 布 
尔 值 ) 











在 我 们 的 示例 中 ， 连 接 池 启动 时 会 创建 5 个 连接 ; 当 需 要 的 时 候 ， 人 允许 
BasicDataSource 创 建新 的 连接 ， 但 最 大 活跃 连接 数 为 10。 


10.2.3 ”基于 JDBC 了 驱动 的 数据 源 
在 Spring 中 ， 通 过 JDBC 了 驱动 定义 数据 源 是 最 简单 的 配置 方式 。Spring 提 


供 了 三 个 这 样 的 数据 源 类 【〈 均 位 于 
org.springframework.jdbc.datasource 包 中 ) 供 选择 : 





。DriverManagerDataSource: 在 每 个 连接 请 求 时 都 会 返回 一 个 新 
建 的 连接 。 与 DBCP 的 BasicDataSource 不 同 ， 
由 DriverManagerDataSource 提 供 的 连接 并 没有 进行 池 化 管理 ; 

。SimpleDriverDataSource: 与 DriverManagerDataSource 的 工 
作 方 式 类 似 ， 但 是 它 直接 使 用 JDBC 驱 动 ， 来 解决 在 特定 环境 下 的 
类 加 载 问 题 ， 这 样 的 环境 包括 OSGi 容 器 ; 

。 SingleConnectionDataSource: 在 每 个 连接 请 求 时 都 会 返回 同 
一 个 的 连接 。 尺 管 singleConnectionDataSource 不 是 严格 意义 
上 的 连接 池 数 据 源 ， 但 是 你 可 以 将 其 视 为 只 有 一 个 连接 的 池 。 


以 上 这 些 数据 源 的 配置 与 DBCPBasicDataSource 的 配置 类 似 。 例 如 ， 
如 下 就 是 配置 DriverManagerDataSource 的 方法 : 


@Bean 


public DataSource dataSource() { 
DriverManagerDataSource ds = new DriverManagerDataSource(); 
ds.setDriverClassName("org.h2.Driver"); 
ds.setUrl("jdbc:h2:tcp://localhost/~/spitter"); 
ds.setUsername("sa"); 
ds.setpassword(""); 
return ds; 





如 果 使 用 XML 的 话 ，DriverManagerDataSource 可 以 按照 如 下 的 方式 
配置 : 


<bean id="dataSource" 
class="org.springframework.jdbc.datasource.DriverManagerDataSource" 
p:driverClassName="org.h2.Driver" 


p:url="jdbc:h2:tcp://localhost/~/spitter" 
p:username="sa" 
p:password="" /> 





与 具备 池 功 能 的 数据 源 相 比 ， 唯 一 的 区 别 在 于 这 些 数据 源 bean 都 没有 提 
供 连 接 池 功能 ， 所 以 没有 可 配置 的 池 相关 的 属性 。 


尽管 这 些 数据 源 对 于 小 应 用 或 开发 环境 来 说 是 不 错 的 ， 但 是 要 将 其 用 于 
生产 环境 ， 你 还 是 需要 慎重 考虑 。 因 

为 SingleConnectionDataSource 有 且 只 有 一 个 数据 库 连 接 ， 所 以 不 
适合 用 于 多 线程 的 应 用 程序 ， 最 好 只 在 测试 的 时 候 使 用 。 

而 DriverManagerDataSource 和 SimpleDriverDataSource 尺 管 支 持 
多 线程 ， 但 是 在 每 次 请 求 连接 的 时 候 都 会 创建 新 连接 ， 这 是 以 性 能 为 代 
价 的 。 鉴 于 以 上 的 这 些 限 制 ， 我 强烈 建议 应 该 使 用 数据 源 连 接 池 。 


10.2.4 使 用 磐 入 式 的 数据 源 


除 此 之 外 ， 还 有 一 个 数据 源 是 我 想 对 读者 介绍 的 : 舱 入 式 数 据 库 

(embedded database )。 骨 入 式 数 据 库 作为 应 用 的 一 部 分 运行 ， 而 不 是 
应 用 连接 的 独立 数据 库 服务 器 。 尽 管 在 生产 环境 的 设置 中 ， 它 并 没有 太 
大 的 用 处 ， 但 是 对 于 开发 和 测试 来 讲 ， 钥 入 式 数 据 库 都 是 很 好 的 可 选 方 
0 0 0 0 


Spring 的 jdbc 命 名 空间 能 够 简化 侍 入 式 数据 库 的 配置 。 例 如 ， 如 下 的 程 




















序 清单 展现 了 如 何 使 用 jdbc 命 名 空间 来 配置 谍 入 式 的 H2 数 据 库 ， 它 会 
预先 加 载 一 组 测试 数据 。 


程序 清单 10.1 使 用 jdbc 命 名 空间 配置 租 入 式 数据 库 


<?xml version="1.060" encoding="UTF-8"?> <beans xmlns="http://www.springframe 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:jdbc="http://www.springframework.org/schema/jdbc" 
xmlns:c="http://www.springframework.org/schema/c" 
xsi:schemaLocation="http://www.springframework.org/schema/jdbc 
http://www.springframework.org/schema/jdbc/spring-jdbc-3.1.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 


<jdbc:embedded- 
database id="dataSource" type="H2"> <jdbc:script location="com/hab 
a/spitter/db/jdbc/schema.sql"/> <jdbc:script location="com/habuma/ 
itter/db/jdbc/test-data.sql"/> </jdbc:embedded-database> 


</beans> 





我 们 将 <jdbc :embedded-database> 的 type 属 性 设置 为 H2， 表 明 幅 入 
式 数据 库 应 该 是 H2 数 据 库 〈 要 确保 H2 位 于 应 用 的 类 路 径 下 ) 。 另 外 ， 
< 还 可 以 将 type 设 置 为 DERBY， 以 使 用 嵌入 式 的 Apache Derby 数 据 


在 <jdbc:embedded-database> 中 ， 我 们 可 以 不 配置 也 可 以 配置 多 个 
<jdbc: script> 元 素来 搭建 数据 库 。 程序 清单 10.1 中 包含 了 两 个 

<jdbc:script> 元 素 : 第 一 个 引用 了 schema.sql， 它 包含 了 在 数据 库 中 
人 的 SQL; 第 二 个 引用 了 test-data.sql， 用 来 将 测试 数据 填充 到 数据 


除了 搭建 艇 入 式 数 据 库 以 外 ，<jdbc:embedded-database> 元 素 还 会 暴 
oo 我 们 可 以 像 使 用 其 他 的 数据 源 那 样 来 使 用 它 。 在 这 

里 ，id 属 性 被 设置 成 了 datasource， 这 也 是 所 暴露 数据 源 的 bean ID。 
因此 ， 当 我 们 需要 javax.sql.DataSource 的 时 候 ， 就 可 以 注 


入 dataSource bean。 


如 果 使 用 Java 来 配置 供 入 式 数据 库 时 ， 不 会 像 jdbc 命 名 空间 那么 简便 ， 








我 们 可 以 使 用 EmbeddedDatabaseBuilder 来 构建 DataSource: 


@Bean 
public DataSource dataSource() { 
return new EmbeddedDatabaseBuilder() 
.SetType(EmbeddedDatabaseType.H2) 


.addScript("classpath:schema.sql") 
.addScript("classpath:test-data.sql") 
.build(); 





可 以 看 到 ，setType( ) 方 法 等 同 于 <jdbc:embedded-database> 元 素 中 
的 type 属 性 ， 此 外 ， 我 们 这 里 用 addscript() 代 蔡 <jdbc:script> 元 
素来 指定 初始 化 SQL。 


10.2.5 “使 用 profile 选 择 数据 源 


我 们 已 经 看 到 了 多 种 在 Spring 中 配置 数据 源 的 方法 ， 我 相信 你 已 经 找到 
了 一 两 种 适合 你 的 应 用 程序 的 配置 方式 。 实 际 上 ， 我 们 很 可 能 面临 这 样 
一 种 需求 ， 那 就 是 在 某 种 环境 下 需要 其 中 一 种 数据 源 ， 而 在 另外 的 环境 
中 需要 不 同 的 数据 源 。 

例如 ， 对 于 开发 期 来 说 ，<jdbc :embedded-database> 元 素 是 很 合适 

的 ， 而 在 QA 环境 中 ， 你 可 能 希望 使 用 DBCP 的 BasicDataSource, 在 

生产 部 蜀 环 境 下 ， 可 能 需要 使 用 <jee:jndi-lookup>。 


我 们 在 第 3 章 所 讨论 的 Spring 的 bean profile 特 性 恰好 用 在 这 里 ， 所 需要 做 
的 束 是 将 每 个 数据 源 配置 在 不 同 的 profile 中 ， 如 下 所 示 : 


程序 清单 10.2 ”借助 Spring 的 profile 特 性 能 够 在 运行 时 选择 数据 源 











package com.habuma.spittr.config; 

import org.apache.commons.dbcp.BasicDataSource; 

import javax.sql.DataSource; 

import org.springframework.context .annotation.Bean; 

import org.springframework.context .annotation.Configuration; 

import org.springframework.context.annotation.Profile; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder; 

import 
org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType:; 

import org.springframework.jndi .JndiObjectFactoryBean; 


@Configuration 
public class DataSourceConfiguration { 


开发 数据 源 
&@Profile("development") 
@Bean 
public DataSource embeddedDataSourcel() { 


return new EmbeddedDatabaseBuilder() 
.SetType(EmbeddedDatabaseType.H2) 
.addscript ("classpath: schema .sql") 
.addscript("classpath:test-data.sql") 


.build()}); 
} 
@Profile("qa") < 一 QA 数据 源 
@Bean 
public DataSource Datal(l)} { 


BasicDataSource ds = new BasicDataSource!(); 
ds.setDriverCclassName ("org.h2.Driver"}); 
ds.setUrl ("jdbc:h2:tcp://localhost/~/spitter"); 
ds.setUsername ("sa"); 

ds.setPassword(""); 

ds.setInitialSize(S); 

ds.setMaxActive(10); 

return ds; 


} 


@Profile("production") pe 生产 环境 的 数据 源 


@Bean 

public DataSource dataSource()} { 
JndiObjectFactoryBean jndiObjectFactoryBean 

= new JndiObjectFactoryBean!(); 

jndiObjectFactoryBean.setJndiName ("jdbc/SpittrDSs"); 
jndiObjectFactoryBean.setResourceRef (true); 
jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class); 
return (DataSource) jndiObjectFactoryBean.getOobject!(); 


通过 使 用 profile 功 能 ， 会 在 运行 时 选择 数据 源 ， 这 取决 于 哪 一 个 profile 

处 于 激活 状态 。 如 程序 清单 10.2 配 置 所 示 ， 当 且 仅 

当 developmentprofile 处 于 激活 状态 时 ， 会 创建 巷 入 式 数 据 库 ， 当 且 仅 
当 qa profile 处 于 激活 状态 时 ， 会 创建 DBCP BasicDataSource， 当 且 仅 
当 productionprofile 处 于 激活 状态 时 ， 会 从 JNDI 获 取 数 据 源 。 


为 了 内 容 的 完整 性 ， 如 下 的 程序 清单 展现 了 如 何 使 用 Spring XML 代 蔡 
Java 配 置 ， 实 现 相 同 的 profile 配 置 。 





程序 清单 10.3 ”借助 XML 配置 ， 基 于 profile 选 择 数据 源 


<?xml version="1.0" encoding="UTF- 
8"?> <beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0org/2001/XMLSchema-instance" 
xmlns: jdbc="http://www. Springtramework .org/schema/jabc" 
xmlns: jee="http://www.springframework.org/schema/jee" 
xmlns:p="*http://www.springframework.org/schema/p" 
xsi:schemaLocation="http://www.springframework .org/schemal/jdbc 
http://www.springframework.org/schema/ijdbc/spring-jdbc-3.1.xsd 
http://www.Sspringframework.org/schema/jee 
http://www. springframework.org/schema/jee/spring-jee-3.1.xsd 
http://www.springframework.org/schema/beans 


开发 http://www.springframework.org/schema/beans/spring-beans.xsd"> 
数据 源 <beans profile="development"> 
<jdbc :embedded- 
database id="dataSource" type="H2"> <jdbc:script location="com/hab 
uma/spitter/db/jdbc/schema.sql"/> <idbc:script location="com/habum 
a/spitter/db/jdbc/test-data.sql"/> </jdbc:embedded- 
database> </beans> 
<beans profile="qa"> a QA 数据 源 


<bean id="dataSource" 
class="org.apache.commons .dbcp.BasicDataSource" 
p:driverClassName="org.h2.Driver" 
p:url="jdbc:h2:tcp://localhost/~/spitter" 
p:username="sa”" 
p:password="" 
p:initialSize="5" 
p:maxActive="10" /> </beans> 
<beans profile="production"> . 生产 环境 的 数据 源 
<jee: jndi-lookup id="dataSource" 
ndi-name="/jAbc/sSpitterDs" 
resource-ref="true" /> </beans> 
</beans> 


现在 我 们 已 经 通过 数据 源 建立 了 与 数据 库 的 连接 ， 接 下 来 要 实际 访问 数 
据 库 了 。 就 像 我 在 前 面 所 提 到 的 ，Spring 为 我 们 提供 了 多 种 使 用 数据 库 
的 方式 包括 JDBC、Hibemate 以 及 Java 持 久 化 API (Java Persistence APTL， 
JPA) 。 在 下 一 节 ， 我 们 将 会 看 到 如 何 使 用 Spring 对 JDBC 的 支持 为 应 用 
程序 构建 持久 层 。 如 采 你 喜欢 使 用 Hibernate 或 JPA， 那 可 以 直接 跳 到 下 


一 童 。 








10.3 ”在 Spring 中 使 用 JDBC 


持久 化 技术 有 很 多 种 ， 而 Hibernate、iBATIS 和 JPA 只 是 其 中 的 几 种 而 
已 。 尽 管 如 此 ， 还 是 有 很 多 的 应 用 程序 使 用 最 古老 的 方式 将 Java 对 象 保 
存 到 数据 库 中 : 他 们 自食其力 。 不 ， 等 等 ， 这 是 他 们 挣 钱 的 途径 。 这 种 
久 经 考验 并 证 明 行 之 有 效 的 持久 化 方法 就 是 古老 的 JDBC。 


为 什么 不 采用 它 呢 ?JDBC 不 要 求 我 们 掌握 其 他 框 染 的 伍 询 语言 。 它 是 
建 并 在 SQL 之 上 的 ， 而 SQL 本 号 就 是 数据 访问 语言 。 此 外 ， 与 其 他 的 技 
术 相 比 ， 使 用 JDBC 能 够 更 好 地 对 数据 访问 的 性 能 进行 调 优 。JDBC 人 允许 
你 使 用 数据 库 的 所 有 特性 ， 而 这 是 其 他 框 淋 不 或 励 其 全 茶 止 的 。 


再 者 ， 相 对 于 持久 层 框 架 ，JDBC 能 够 让 我 们 在 更 低 的 层次 上 处 理 数 
据 ， 我 们 可 以 完全 控制 应 用 程序 如 何 读 取 和 管理 数据 ， 包 括 访 问 和 管理 
数据 库 中 单独 的 列 。 这 种 细 粒 度 的 数据 访问 方式 在 很 多 应 用 程序 中 是 很 
方便 的 。 例 如 在 报表 应 用 中 ， 如 宁 将 数据 组 织 为 对 象 ， 而 接 下 来 唯一 要 
做 的 就 是 将 其 解 包 为 原始 数据 ， 那 束 没 有 太 大 意义 了 。 


但 是 JDBC 也 不 是 十 全 十 美的 。 虽 然 JDBC 具 有 强大 、 灵 活 和 其 他 一 些 优 
点 ， 但 也 有 其 不 足 之 处 。 


10.3.1 应 对 失控 的 JDBC 代 码 

如 果 使 用 JDBC 所 提供 的 直接 操作 数据 库 的 API， 你 需要 负责 处 理 与 数据 
库 访 问 相 关 的 所 有 事情 ， 其 中 包含 管理 数据 库 资 源 和 处 理 异 常 。 如 果 你 
曾经 使 用 JDBC 往 数据 库 中 插入 数据 ， 那 如 下 代码 对 你 应 该 并 不 陌生 : 


程序 清单 10.4 使 用 JDBC 在 数据 库 里 插入 一 行 数据 





























获取 连接 
L_INSERT_SPITTTER) <- 创建 语句 
绑 定 参 数 





iot sure what, though 





(以 某 种 方式 ) 
处 理 异常 


看 看 这 些 失 控 的 代码 ! 这 个 超过 20 行 的 代码 仅仅 是 为 了 同 数 据 库 中 插入 
一 个 简单 的 对 象 。 对 于 JDBC 操 作 来 讲 ， 这 应 该 是 最 简单 的 了 。 但 是 为 
什么 要 用 这 么 多 行 代码 才能 做 如 此 简单 的 事情 呢 ? 实际 上 ， 并 非 如 此 ， 
只 有 几 行 代码 是 真正 用 于 进行 插入 数据 的 。 但 是 JDBC 要 求 你 必须 正确 
地 管理 连接 和 语句 ， 并 以 某 种 方式 处 理 可 能 抛 出 的 SQLException 腊 


ir 


吊 。 











再 提 一 名 这 个 SQLException 肛 着 : 你 不 但 不 清楚 如 何 处 理 它 (因为 并 
不 知道 哪里 出 错 了 ) ， 而 且 你 还 要 捕捉 它 两 次 ! 你 需要 在 插入 记录 出 错 
时 捕捉 它 ， 同 时 你 还 需要 在 关闭 语句 和 连接 出 错 的 时 候 捕捉 它 。 看 起 来 
我 们 要 做 很 多 的 工作 来 处 理 可 能 出 现 的 问题 ， 而 这 些 问 题 通常 是 难以 通 
过 编码 来 处 理 的 。 


再 来 看 一 下 如 下 程序 清单 中 的 代码 ， 我 们 使 用 传统 的 JDBC 来 更 新 数据 
库 中 spitter 表 的 一 行 。 


程序 清单 10.5 ”使 用 JDBC 更 新 数据 库 中 的 一 行 











private static final String SQL UPDATE SPITTER = 


"Update spitter set Username = ?, passworad = ?, fullname = ?" 
+ "where id = 2?"; 
public void saveSpitter(Spitter spitter) { 
Connection conn = null; 
PreparedStatement stmt = null; 
f 
本 . 获取 连接 
conn = dataSource.getConnectiont{(); 
stmt = conn.prepareStatement (SQL_UPDRTE_SPITTER ) 创建 语句 
stmt.setString{(l1, spitter.getUsername{()); 


stmt.setSstring{t2, spitter.getPassword()); 绑 定 参数 
stmt.SsetStringf{3，spitter.getFullNamef)): 
执行 stmt,.setLong{(4, spitter.getIid(})); 
语句 stmt .execute{); 
} catch (SQLException e) { 


// Still not sure What I'm supposed to do here 
(以 某 种 方式 ) 


} finally { 
处 理 异常 


try { 

£f {stmt != null) 1 清理 资源 
stmt.close(); 

} 

if {conn != null) { 
conn.closet{); 
} 

} catch {SQLExcepvtion e) | 


or here 


} 


乍 看 上 去 ， 程 序 清 单 10.5 和 10.4 是 相同 的 。 实 际 上 ， 除 了 SQL 字符 串 和 
创建 语句 的 那 一 行 ， 它 们 是 完全 相同 的 。 同 样 ， 这 里 也 使 用 大 量 代 码 来 
完成 一 件 简 单 的 事情 ， 而 且 有 很 多 重复 的 代码 。 在 理想 情况 下 ， 我 们 只 
需要 编写 与 特定 任务 相关 的 代码 。 毕 竟 ， 这 才 是 程序 清单 10.5 和 10.4 的 
不 同 之 处 ， 剩 下 的 都 是 样板 代码 。 


为 了 完成 对 JDBC 的 完整 介绍 ， 让 我 们 看 一 下 如 何 从 数据 库 中 获取 数 
据 。 如 下 所 示 ， 它 也 不 简单 。 


程序 清单 10.6 ”使 用 JDBC 从 数据 库 中 查询 一 行 数据 











private static final String SQL_ SELECT_SPITTER = 
"select id, username, fullname from spitter where id = ?"; 


public Spitter findonellong id) { 


Connection conn = null; 
PreparedStatement stmt = null; 
ResultSet rs = null; 
tr, { J Ty Phe 
Te , 本 获取 连接 
conn = dataSource.getConnection(); 
stmt = conn.prepareStatement (SQL_SELEC SPITTER) ; > ~ 
jg m conn prepa atement (SQL_SELECT_S ER); 创建 语句 
执行 stmt.setLong(1, id) 
\ 各 人 i ‘ & 
语句 rs = stmt .executeQueryl(); 绑 定 参数 
Spitter SPitter = null; 
if (rs.next(})) 1 TH 二 月 
i ( next()) 1 处 理 结果 


spitter = new Spitter'(); 
spitter,.setIid(rs.ge “ 





} 
return spitter; 


} catch (SQLException e) { (以 某 种 方式 ) 处 理 异常 


} finally { 


if(rs != null) { 
bey { 
rs.close(); 


} catch(SQLException e) {} 


} 

if{stmt != null) 1{ 
Sox , 清理 资源 
stmt.close(); 


} catch (SQLException el {} 


} 
if{conn != null) { 
try 1 
conn.closel{); 
} catch(SQLException e) {} 
} 
} 


return null; 


这 段 代 码 与 插入 和 更 新 的 样 例 一 样 元 长 ， 甚 至 更 为 复杂 。 这 就 好 像 
Pareto 法 则 被 倒 了 过 来 : 只 有 20% 的 代码 是 真正 用 于 查询 数据 的 ， 而 
80% 代 码 都 是 样板 代码 。 


现在 你 可 以 看 出 ， 大 量 的 JDBC 代 码 都 是 用 于 创建 连接 和 语句 以 及 异 名 
处 理 的 样板 代码 。 既 然 已 经 得 出 了 这 个 观点 ， 我 们 将 不 再 接受 它 的 折 
磨 ， 以 后 你 再 也 不 会 看 到 这 样 令 人 厌恶 的 代码 了 。 


但 实际 上 ， 这 些 样 板 代 码 是 非常 重要 的 。 清 理 资 源 和 处 理 错 误 确 保 了 数 
据 访 问 的 健壮 性 。 如 果 没 有 它们 的 话 ， 就 不 会 发 现 错误 而 且 资源 也 会 处 
于 打开 的 状态 ， 这 将 会 导致 意外 的 代码 和 资源 泄露 。 我 们 不 仅 需 要 这 些 
代码 ， 而 且 还 要 保证 它 是 正确 的 。 基 于 这 样 的 原因 ， 我 们 才 需 要 框 染 来 
保证 这 些 代 码 只 写 一 次 而 且 是 正确 的 。 











10.3.2 ”使 用 JDBC 模 板 


Spring 的 JDBC 框 架 承 担 了 资源 管理 和 有 异常 处 理 的 工作 ， 从 而 简化 了 
JDBC 人 代码， 让 我 们 只 需 编写 从 数据 库 读 写 数据 的 必需 代码 。 


正如 前 面 小 节 所 介绍 过 的 ，Spring 将 数据 访问 的 样板 代码 抽象 到 模板 类 
之 中 。Spring 为 JDBC 提 供 了 三 个 模板 类 供 选 择 : 


。 JdbcTemplate: 最 基本 的 Spring JDBC 模 板 ， 这 个 模板 支持 简单 的 
JDBC 数 据 库 访问 功能 以 及 基于 索引 参数 的 查询 ; 

。NamedParameterJdbcTemplate: 使 用 该 模板 类 执行 查询 时 可 以 
i 而 不 是 使 用 简单 的 索引 参 


。 SimpleJdbcTemplate: 该 模板 类 利用 Java 5 的 一 些 特性 如 自动 装 
箱 、 泛 型 以 及 可 变 参 数列 表 来 简化 JDBC 模 板 的 使 用 。 


以 前 ， 在 选择 哪 一 个 JDBC 模 板 的 时 候 ， 我 们 需要 仔细 权衡 。 但 是 从 
Spring 3.1 开 始 ， 做 这 个 决定 变 得 容易 多 了 。SimpleJdbcTemplate 已 经 
被 废弃 了 ， 其 Java 5 的 特性 被 转移 到 了 JdbcTemplate 中 ， 并 且 只 有 在 你 
需要 使 用 命名 参数 的 时 候 ， 才 需要 使 

用 NamedParameterJdbcTemplate。 这 样 的 话 ， 对 于 大 多 数 的 JDBC 任 
JdbcTemplate 束 是 最 好 的 可 选 方 案 ， 这 也 是 本 小 节 中 所 关注 
方案。 


使 用 JdbcTemplate 来 插入 数据 
为 了 让 JdbcTemplate 正 常 工作 ， 只 需要 为 其 设置 DataSsource 就 可 以 


了 ， 这 使 得 在 Spring 中 配置 JdbcTemplate 非 常 容易 ， 如 下 面 的 @Bean 方 
法 所 示 : 








@Bean 
public JdbcTemplate jdbcTemplate(DataSource dataSource) { 
return new JdbcTemplate(dataSource); 


在 这 里 ，DataSource 是 通过 构造 器 参数 注入 进来 的 。 这 里 所 引用 的 
dataSourcebean 可 以 是 javax.sql.DataSource 的 任意 实现 ， 包 括 我 
们 在 10.2 小 节 中 所 创建 的 。 


现在 ， 我 们 可 以 将 jdbcTemp1late 装 配 到 Repository 中 并 使 用 它 来 访问 数 
据 库 。 例 如 ，SpitterRepository 使 用 了 JdbcTemplate: 


@Repository 

public class JdbcSpitterRepository implements SpitterRepository { 
private JdbcOperations jdbcOperations; 
@Inject 


public JdbcSpitterRepository(JdbcOperations jdbcOperations) { 
this.jdbcOperations = jdbcOperations; 
} 





在 这 里 ，JdbcSspitterRepository 类 上 使 用 了 Q@Repository 注 解 ， 这 
表明 它 将 会 在 组 件 扫描 的 时 候 自 动 创 建 。 它 的 构造 器 上 使 用 了 QInject 
注解 ， 因 此 在 创建 的 时 候 ， 会 自动 获得 一 个 JdbcOperations 对 

象 。JdbcOperations 是 一 个 接口 ， 定 义 了 JdbcTemplate 所 实现 的 操 
作 。 通 过 注入 JdbcOperations， 而 不 是 具体 的 JdbcTemplate， 能 够 
保证 JdbcSpitterRepository 通 过 Jdbcoperations 接 口 达 到 

与 ]dbcTemp1late 保 持 松 耦 合 。 


作为 另外 一 种 组 件 扫 摘 和 上 自动 装配 的 方案 ， 我 们 可 以 
将 JdbcSspitterRepository 显 式 声 明 为 Spring 中 的 bean， 如 下 所 示 : 





@Bean 
public SpitterRepository spitterRepository(JdbcTemplate jdbcTemplate) { 


return new JdbcSpitterRepository(jdbcTemplate); 
} 





在 Repository 中 具备 可 用 的 JdbcTemplate 后 ， 我 们 可 以 极 大 地 简化 程序 
清单 10.4 中 的 addSpitter() 方 法 。 基 于 JdbcTemplate 的 
addSpitter() 方 法 如 下 : 


程序 清单 10.7 ”基于 JdbcTemplate 的 addSpitter() 方 法 


public void addSpitter(Spitter spitter) { 


jdbcOoperations.update {INSERT_SPITTER, 插入 Spitter 





这 个 版 本 的 addSpitter() 方 法 简单 多 了 。 这 里 没有 了 创建 连接 和 语句 
的 代码 ， 也 没有 蜡 常 处 理 的 代码 ， 只 剩 下 单纯 的 数据 插入 代码 。 


不 能 因为 你 看 不 到 这 些 样 板 代 码 ， 就 意味 着 它 们 不 存在 。 样 板 代码 被 巧 
妙 地 隐藏 到 JDBC 模 板 类 中 了 。 当 update() 方 法 被 调用 的 时 
候 JdbcTemplate 将 会 获取 连接 、 创 建 语句 并 执行 插入 SQL。 


在 这 里 ， 你 也 看 不 到 对 SQLException 处 理 的 代码 。 在 内 部 ， 
JdbcTemplate 将 会 捕获 所 有 可 能 抛 出 的 SQLException， 并 将 通用 的 
SQLException 转 换 为 表 10.1 所 列 的 那些 更 明确 的 数据 访问 异常 ， 然 后 
将 其 重新 抛 出 。 因 为 Spring 的 数据 访问 异常 都 是 运行 时 异常 ， 所 以 我 们 
不 必 在 addspring () 方 法 中 进行 捕获 。 

使 用 JdbcTemplate 来 读 取 数据 
JdbcTemplate 也 简化 了 数据 的 读 取 操作 。 程 序 清单 10.8 展 现 了 新 版 本 
的 findone() 方 法 ， 它 使 用 了 JdbcTemplate 的 回调 ， 实 现 根 据 ID 查询 
Spitter， 并 将 结果 集 映 射 为 Spitter 对 象 。 


程序 清单 10.8 使 用 JdbcTemplate 查 询 Spitter 





< 
i1e@ryForObject ( 查询 Spitter 
ew Spi rRowMapper (), 





将 查 结果 
映射 到 对 象 








在 这 个 findone( ) 方 法 中 使 用 了 JdbcTemplate 的 queryForObject() 
方法 来 从 数据 库 查询 spitter。queryFor0bject() 方 法 有 三 个 参数 : 


。 String 对 象 ， 包 含 了 要 从 数据 库 中 查找 数据 的 SQL; 





。 RowMapper 对 象 ， 用 来 从 ResultSset 中 提取 数据 并 构建 域 对 象 〈 本 
例 中 为 Spitter) ; 
。 可 变 参 数列 表 ， 列 出 了 要 绑 定 到 查询 上 的 索引 参数 值 。 


真正 奇妙 的 事情 发 生 在 SpitterRowMapper 对 象 中 ， 它 实现 了 
RowMapper 接 口 。 对 于 查询 返回 的 每 一 行 数据 ，JdbcTemplate 将 会 调 
用 RowMapper 的 mapRow() 方 法 ， 并 传 入 一 个 Resultset 和 包含 行 号 的 
整数 。 在 SpitterRowMapper 的 mapRow( ) 方 法 中 ， 我 们 创建 了 spitter 
对 象 并 将 ResultSset 中 的 值 填充 进去 。 


就 像 addspitter() 那 样 ，findone() 方 法 也 不 用 写 JDBC 模 板 代 码 。 不 
同 于 传统 的 JDBC， 这 里 没有 资源 管理 或 者 异常 处 理 代 码 。 使 

用 JdbcTemplate 的 方法 只 需 关 注 于 如 何 从 数据 库 中 获取 Spitter 对 象 
即 可 。 














在 JdbcTemplate 中 使 用 Java 8 的 Lambda 表 达 式 


因为 RowMapper 接 口上 只 声明 了 addRow() 这 一 个 方法 ， 因 此 它 完全 符合 
函数 式 接口 〈functional interface) 的 标准 。 这 意味 着 如 果 使 用 Java 8 来 
开发 应 用 的 话 ， 我 们 可 以 使 用 Lambda 来 表达 RowMapper 的 实现 ， 而 不 
必 再 使 用 具体 的 实现 类 了 。 


例如 ， 程 序 清单 10.8 中 的 findone() 方 法 可 以 使 用 Java 8 的 Lambda 表 达 
式 改 写 ， 如 下 所 示 : 





public Spitter findone(long id) { 
return jdbcOperations.queryForObject( 
SELECT_SPITTER BY_ID, 
(rs, rowNum) -&gt; { 
return new Spitter( 
.getLong("id"), 
.getString("username"), 


.getString("password"), 
.getString("fullName"), 
.getString("email"), 
.getBoolean("updateByEmail")); 





我 们 可 以 看 到 ，Lambda 表 达 式 要 比 完 整 的 RowMapper 实 现 更 为 易 读 ， 


不 过 它们 的 功能 是 相同 的 。Java 会 限制 RowMapper 中 的 Lambda 表 达 式 ， 
使 其 满足 所 传 入 的 参数 。 


2 我 们 还 可 以 使 用 Java 8 的 方法 引用 ， 在 单独 的 方法 中 定义 映射 多 
时 : 


public Spitter findone(long id) { 
return jdbcOperations.queryForObject( 
SELECT_SPITTER BY_ID, this::mapSpitter, id); 


} 
private Spitter mapSpitter(ResultSet rs, int row) throws SQLException { 
return new Spitter( 
rs.getLong("id"), 
rs.getString("username"), 
rs.getString("password"), 
rs.getString("fullName"), 
rs.getString("email"), 
rs.getBoolean("updateByEmail")); 





不 管 采用 哪 种 方式 ， 我 们 都 不 必 显 式 实现 RowMapper 接 口 ， 但 是 与 实现 
RowMapper 类 似 ， 我 们 所 提供 的 Lambda 表 达 式 和 方法 必须 要 接受 相同 
的 参数 ， 并 返回 相同 的 类 型 。 


使 用 命名 参数 


在 清单 10.7 的 代码 中 ，addspitter() 方 法 使 用 了 索引 参数 。 这 意味 着 
我 们 需要 留意 查询 中 参数 的 顺序 ， 在 将 值 传递 给 update() 方 法 的 时 候 
要 保持 正确 的 顺序 。 如 果 在 修改 SQL 时 更 改 了 参数 的 顺序 ， 那 我 们 还 需 
要 修改 参数 值 的 顺序 。 


除了 这 种 方法 之 外 ， 我 们 还 可 以 使 用 命名 参数 。 命 名 参数 可 以 赋予 SQL 
中 的 每 个 参数 一 个 明确 的 名 字 ， 在 绑 定 值 到 查询 语句 的 时 候 就 通过 该 名 
字 来 引用 参数 。 例 如 ， 假 设 SQL_INSERT_SPITTER 查 询 语句 是 这 样 定义 


人 : 











private static final String SQL_INSERT_SPITTER = 
"insert into spitter (username, password, fullname) " + 





"values (:username, :password, :fullname)"; 


使 用 命名 参数 奉 询 ， 绑 定 值 的 顺序 吕 不 重要 了 ， 我 们 可 以 按照 名 字 来 绑 


定 值 。 如 果 碍 询 语句 发 生 了 变化 导致 参数 的 顺序 与 之 前 不 一 致 ， 我 们 不 
斋 要 修改 绑 定 的 代码 。 


NamedParameterJdbcTemplate 是 一 个 特殊 的 JDBC 模 板 类 ， 它 支持 使 
用 命名 参数 。 在 Spring 中 ，NamedParameterJdbcTemplate 的 声明 方式 
与 常规 的 ]JdbcTemplate 几 乎 完全 相同 : 








@Bean 
public NamedParameterJdbcTemplate jdbcTemplate(DataSource dataSource) { 


return new NamedParameterJdbcTemplate(dataSource); 


} 


在 这 里 ， 我 们 

将 NamedParameterJdbcOperations (NamedParameterJdbcTemplat. 
所 实现 的 接口 ) 注入 到 Repository 中 ， 用 它 来 葵 代 Jdbcoperations。 现 
在 的 addSpitter() 方 法 如 下 所 示 : 


程序 清单 10.9 使 用 Spring JDBC 模 板 的 命名 参数 功能 


private static final String INSERT SPITTER = 








me, password, fullname, email, updateByEmail) " 





(:username, :password, :fullname, :email, :updateByEmail)})"; 


public voic 
ig, Object>!(); 


EY 
) ) ; 铸 定 参数 
) ) ; 
) ) ; 





e", spitter. getFullNa ame ( 





tter.getEmail()); 


ot tter.isUpdateByEmail()); 


NSERT_SPITTER, paramMap); 执行 数据 插入 


jdbcOperations .update (IN 


Y 
J 


这 个 版 本 的 addSpitter() 比 前 一 版 本 的 代码 要 长 一 些 。 这 是 因为 命名 
参数 是 通过 java.util1.Map 来 进行 绑 定 的 。 不 过 ， 1 
数据 库 中 插入 Spitter 对 象 。 这 个 方法 的 核心 功能 并 不 会 被 资源 管理 或 
异常 处 理 这 样 的 代码 所 充斥 。 


10.4 ”小 结 

数据 是 应 用 程序 的 血液 。 有 些 数据 中 心 论 者 甚至 主张 数据 即 应 用 。 鉴 于 
数据 的 重要 地 位 ， 以 人 健壮、 简单 和 清晰 的 方式 开发 应 用 程序 的 数据 访问 
部 分 就 显得 举足轻重 了 。 

在 Java 中 ，JDBC 是 与 关系 型 数据 库 交 互 的 最 基本 方式 。 但 是 按照 规 
范 ，JDBC 有 些 太 策 重 了 。Spring 能 够 解除 我 们 使 用 JDBC 中 的 大 多 数 痛 
苦 ， 包 括 消 除 样 板式 代码 、 简 化 JDBC 异 常 处 理 ， 你 所 需要 做 的 仅仅 是 
关注 要 执行 的 SQL 语句 。 

在 本 章 中 ， 我 们 学 习 了 Spring 对 数据 持久 化 的 文 持 ， 以 及 Spring 为 JDBC 
所 提供 的 基于 模板 的 抽象 ， 它 能 够 极 大 地 简化 JDBC 的 使 用 。 


在 下 一 章 中 ， 我 们 会 继续 Spring 数据 持久 化 这 一 话题 ， 将 会 学 习 Spring 
为 Java 持 久 化 API 所 提供 的 功能 。 








第 11 章 ”使 用 对 象 -关系 映射 持久 化 
数据 


本 章 内 容 : 


。 使 用 Spring 和 Hibernate 
。 借助 上 下 文 Session， 编 写 不 依赖 于 Spring 的 Repository 
。 通 过 Spring 使 用 JPA 

。 借助 Spring Data 实 现 自动 化 的 JPA Repository 


小 时 候 ， 骑 上 自行 车 是 一 件 很 有 趣 的 事情 ， 对 吧 ? 在 清晨 ， 我 们 骑 车 上 
学 。 放 学 后 ， 我 们 游 逛 到 朋友 家 。 当 天 色 渐 晚 之 时 ， 在 父母 的 呼喊 声 
中 ， 我 们 骑 车 回 家 。 那 些 日 子 真 的 很 有 意思 ! 


后 来 ， 随 着 慢 慢 长 大 ， 现 在 我 们 所 需要 的 不 仅仅 是 一 辆 上 自行 车 了 。 有 
时 ， 我 们 需要 走 很 远 的 路 去 上 班 或 需要 装载 一 些 生 活用 品 ， 还 有 可 能 接 
送 孩 子 去 上 足球 读 。 如 果 生 活 在 得 殉 蔷 斯 州 的 话 ， 我 们 还 必须 需要 一 合 
空调 。 我 们 的 需求 超出 了 自行 车 的 功能 范围 。 


在 数据 持久 化 的 世界 中 ，JDBC 就 像 目 行车 。 对 于 份 内 的 工作 ， 所 能 很 
好 地 完成 并 且 在 一 些 特定 的 场景 下 表现 出 色 。 但 随 着 应 用 程序 变 得 越 来 
越 复 杀 ， 对 持久 化 的 需求 也 变 得 更 复杂 。 我 们 需要 将 对 象 的 属性 映射 到 
数据 库 的 列 上 ， 并 且 需 要 上 自动 生成 语句 和 查询 ， 这 样 我 们 就 能 从 无 休止 
的 问号 字符 串 中 解脱 出 来 。 此 外 ， 我 们 还 需要 一 些 更 复杂 的 特性 : 


。 延迟 加 载 (Lazy 1joading) : 随 着 我 们 的 对 象 关 系 变 得 越 来 越 复杂 ， 
有 时 候 我 们 并 不 希望 立即 获取 完整 的 对 象 间 关系 。 举 一 个 典型 的 例 
子 ， 假 设 我 们 在 查询 一 组 PurchaseOrder 对 象 ， 而 每 个 对 象 中 都 包 
售 一 个 LineItem 对 象 集合 。 如 果 我 们 只 关心 PurchaseOrder 的 属 
性 ， 那 查询 出 LineItem 的 数据 就 又 无 意义 。 而 且 这 可 能 是 开销 很 
大 的 操作 。 延 迟 加 载 允许 我 们 只 在 需要 的 时 候 获取 数据 。 

。 预先 抓 取 (Eager fetching〉 : 这 与 延迟 加 载 是 相对 的 。 借 助 于 预先 
抓 取 ， 我 们 可 以 使 用 一 个 得 询 获取 完整 的 关联 对 象 。 如 果 我 们 需要 
PurchaseOrder 及 其 关联 的 LineItem 对 象 ， 预 先 抓 取 的 功能 可 以 





















































在 一 个 操作 中 将 它们 全 部 从 数据 库 中 取出 来 ， 节 省 了 多 次 查询 的 成 


。 级 联 (Cascading) : 有 时 ， 更 改 数据 库 中 的 表 会 同时 修改 其 他 
表 。 回 到 我 们 订购 单 的 例子 中 ， 当 删除 Order 对象 时 ， 我 们 希望 同 
时 在 数据 库 中 删除 关联 的 LineITtem。 


一 些 可 用 的 框架 提供 了 这 样 的 服务 ， 这 些 服务 的 通用 名 称 是 对 象 /关系 
映射 (object-relational mapping，ORM) 。 在 持久 层 使 用 ORM 工 具 ， 可 
以 节省 数 千 行 的 代码 和 大 量 的 开发 时 间 。ORM 工 具 能 够 把 你 的 注意 力 
从 容易 出 错 的 SQL 代码 转生 如何 实 现 应 用 程序 的 真正 需求 。 


Spring 对 多 个 持久 化 框架 都 提供 了 支持 ， 包 括 Hibernate、iBATIS、Java 
数据 对 象 〈Java Data Objects，JDO) 以 及 Java 持 久 化 API (Java 
Persistence API，JPA) 。 与 Spring 对 JDBC 的 支持 那样 ，Spring 对 ORM 框 
架 的 文 持 提供 了 与 这 些 框架 的 集成 点 以 及 一 些 附 加 的 服务 : 


。 支持 集成 Spring 声明 式 事务 ; 
透明 的 异常 处 理 ; 

线程 安全 的 、 轻 量 级 的 模板 类 ; 
DAO 文 持 类 ; 

资源 管理 。 


本 章 没 有 足够 的 篇 幅 介 绍 Spring 文 持 的 全 部 ORM 框 名。 其 实 这 并 不 会 有 
什么 问题 ， 因 为 Spring 对 不 同 ORM 解 决 方案 的 支持 是 很 相似 的 。 一 旦 掌 
所 了 Spring 对 茶 种 ORM 框 架 的 文 持 后 ， 你 可 以 轻松 地 切换 到 另 一 个 杠 
架 。 








在 本 章 中 ， 我 们 将 会 看 到 Spring 如 何 与 最 常用 的 两 种 ORM 方 案 集成 : 
Hibernate 和 JPA。 同 时 还 会 通过 Spring Data JPA 了 解 一 下 Spring Data 项 
目 。 借 助 这 种 方式 ， 我 们 不 仅 可 以 学 习 到 如 何 借 助 Spring Data JPA 移 除 
JPA Repository 中 的 样板 式 代 码 ， 还 能 为 下 一 章 的 如 何 将 Spring Data 用 于 
无 模式 的 存储 打下 基础 。 


让 我 们 先 来 看 看 Spring 是 如 何 为 Hibernate 提 供 文 持 的 。 





11.1 在 Spring 中 集成 Hibernate 


Hibernate 是 在 开发 者 社区 很 流行 的 开源 持久 化 框架 。 它 不 仪 提供 了 基本 
的 对 象 关系 映射 ， 还 提供 了 ORM 工 具 所 应 具有 的 所 有 复杂 功能 ， 比 如 
绥 存 、 延 迟 加 载 、 预 先 抓 取 以 及 分 布 式 缓存 。 


在 本 章 中 ， 我 们 会 关注 Spring 如 何 与 Hibernate 集 成 ， 而 不 会 涉及 太 多 
Hibernate 使 用 时 的 复杂 细节 。 如 果 你 需要 了 解 更 多 关于 Hibernate 如 何 使 
用 的 知识 ， 我 推荐 你 阅读 Christian Bauer、Gavin King 和 Gary Gregory 舞 
写 的 《Java Persistence with Hibernate, Second Edition》 (Manning, 
2014，www.manning.com/bauer3/) 或 访问 Hibernate 的 网 站 
http://www.hibernate.org。 





11.1.1 声明 HibernateHjSession 工厂 


使 用 Hibernate 所 需 的 主要 接口 是 org.hibernate.Session。Session 
接口 提供 了 基本 的 数据 访问 功能 ， 如 保存 、 更 新 、 删 除 以 及 从 数据 库 加 
载 对 象 的 功能 。 通 过 Hibernate 的 Session 接 口 ， 应 用 程序 的 Repository 能 
够 满足 所 有 的 持久 化 需求 。 


获取 Hibernate Session 对 象 的 标准 方式 是 借助 于 Hibernate 
SessionFactory 接 口 的 实现 类 。 除 了 一 些 其 他 的 任 

务 ，SessionFactory 主 要 负责 Hibernate Session 的 打开 、 关 闭 以 及 管 
理 。 





在 Spring 中 ， 我 们 要 通过 Spring 的 某 一 个 Hibernate Session 工 厂 bean 来 获 
取 Hibernate SessionFactory。 从 3.1 版 本 开始 ，Spring 提 供 了 三 个 
Session 工 厂 bean 供 我 们 选择 : 


e org.springframework.orm.hibernate3.LocalSessionFactor. 
e org.springframework.orm.hibernate3.annotation.Annotat. 
e org.Sspringframework.orm.hibernate4.LocalSesslionFactor' 


这 些 Session 工 厂 bean 都 是 Spring FactoryBean 接 口 的 实现 ， 它 们 会 产生 
一 个 HibernateSsessionFactory， 它 能 够 装配 进 任何 SessionFactory 


类 型 的 属性 中 。 这 样 的 话 ， 惑 能 在 应 用 的 Spring 上 下 文中 ， 与 其 他 的 


bean 一 起 配置 Hibernate Session 工 厂 。 


至 于 选择 使 用 哪 一 个 Session 工厂， 这 取决 于 使 用 哪个 版 本 的 Hibernate 以 
及 你 使 用 XML 还 是 使 用 注解 来 定义 对 象 -数据 库 之 间 的 映射 和 关系。 如果 
你 使 用 Hibernate 3.2 或 更 高 版 本 〈 直 到 Hibernate 4.0， 但 不 包含 这 个 版 
本 ) 并 且 使 用 XML 定义 映射 的 话 ， 那 么 你 需要 定义 Spring 的 
org.springframework.orm.hibernate3 包 中 的 
LocalSessionFactoryBean: 


@Bean 

public LocalSessionFactoryBean sessionFactory(DataSource dataSource) { 
LocalSessionFactoryBean sfb = new LocalSessionFactoryBean(); 
sfb .setDataSource(dataSource ) ; 
sfb .setMappingResources(new String[] { "Spitter.hbm.xml" }); 


Properties props = new Properties() 
props.setPproperty("dialect", "org.hibernate.dialect.H2Dialect"); 
sfb .setHibernateProperties(props ) ; 

return sfb; 





在 配置 LocalsessionFactoryBean 时 ， 我 们 使 用 了 三 个 属性 。 属 

性 dataSource 装 配 了 一 个 DataSource bean 的 引用 。 属 

性 mappingResources 列 出 了 一 个 或 多 个 的 Hibernate 映 射 文件 ， 在 这 些 
文件 中 定义 了 应 用 程序 的 持久 化 策略 。 最 后 ，hibernateProperties 
属性 配置 了 Hibernate 如 何 进 行 操作 的 细节 。 在 本 示例 中 ， 我 们 配置 
Hibernate 使 用 H2 数 据 库 并 且 要 按照 H2Dialect 来 构建 SQL 。 


如 果 你 更 倾 癌 于 使 用 注解 的 方式 来 定义 持久 化 ， 并 且 你 还 没有 使 用 
Hibernate 4 的 话 ， 那 么 需要 使 用 AnnotationSessionFactoryBean 来 代 
蔡 LocalSessionFactoryBean: 


@Bean 

public AnnotationSessionFactoryBean sessionFactory(DataSource ds) { 
AnnotationSessionFactoryBean sfb = new AnnotationSessionFactoryBean(); 
sfb.setDataSource(ds); 
sfb.setPpackagesToScan(new String[] { "com.habuma.spittr.domain" }); 


Properties props = new Properties(); 
props.setPproperty("dialect", "org.hibernate.dialect.H2Dialect"); 
sfb.setHibernatePproperties(props); 

return sfb; 





如 果 你 使 用 Hibernate 4 的 话 ， 那 么 就 应 该 使 

用 org.springframework.orm.hibernate4 中 的 
LocalSessionFactoryBean。 尺 管 它 与 Hibernate 3 包 中 的 
LocalSessionFactoryBean 使 用 了 相同 的 名 称 ， 但 是 Spring 3.1 新 引入 
的 这 个 Session 工 厂 类 似 于 Hibernate 3 中 LocalSessionFactoryBean 和 
AnnotationSessionFactoryBean 的 结合 体 。 它 有 很 多 相同 的 属性 ， 
能 够 文 持 基 于 XML 的 映射 和 基于 注解 的 映射 。 如 下 的 代码 展现 了 如 何 
对 它 进 行 配置 ， 使 其 文 持 基 于 注解 的 映射 : 


@Bean 

public LocalSessionFactoryBean sessionFactory(DataSource dataSource) { 
LocalSessionFactoryBean sfb = new LocalSessionFactoryBean(); 
sfb.setDataSource(dataSource); 
sfb.setPpackagesToScan(new String[] { "com.habuma.spittr.domain" }); 


Properties props = new Properties(); 
props.setPproperty("dialect", "org.hibernate.dialect.H2Dialect"); 
sfb .setHibernateProperties(props ) ; 

return sfb; 





在 这 两 个 配置 中 ，dataSource 和 和 hibernateProperties 属 性 都 声明 了 
从 哪里 获取 数据 库 连 接 以 及 要 使 用 哪 一 种 数据 库 。 这 里 不 再 列 出 
Hibernate 配 置 文件 ， 而 是 使 用 packagesToSscan 属 性 告诉 Spring 扫描 一 
个 或 多 个 包 以 查找 域 类 ， 这 些 类 通过 注解 的 方式 表明 要 使 用 Hibernate 进 
行 持 久 化 ， 这 些 类 可 以 使 用 的 注解 包括 JPA 的 @Entity 

或 @MappedSuperclass 以 及 Hibernate 的 @Entity。 


如 果 愿 意 的 话 ， 你 还 可 以 使 用 annotatedClasses 属 性 来 将 应 用 程序 中 
所 有 的 持久 化 类 以 全 限定 名 的 方式 明确 列 出 : 








sfb.setAnnotatedClasses( 
new Cl1ass<?>[] { Spitter.class, Spittle.class } 
); 


annotatedClasses 属 性 对 于 准确 指定 少量 的 域 类 是 不 错 的 选择 。 如 果 
你 有 很 多 的 域 类 并 且 不 想 将 其 全 部 列 出 ， 又 或 者 你 想 自 由 地 添加 或 移 除 
域 类 而 不 想 修改 Spring 配置 的 话 ， 那 使 用 packagesToSscan 属 性 是 更 合 

适 的 。 


在 Spring 应 用 上 下 文中 配置 完 Hibernate 的 Session 工 厂 bean 后 ， 那 我 们 就 


可 以 创建 自己 的 Repository 类 了 。 
11.1.2 ”构建 不 依赖 于 Spring 的 Hibernate 代 人 码 


在 Spring 和 Hibernate 的 早期 岁月 中 ， 编 写 Repository 类 将 会 涉及 到 使 用 
Spring 的 HibernateTemplate。HibernateTemplate 能 够 保证 每 个 事 
务 使 用 同一 个 Session。 但 是 这 种 方式 的 弊端 在 于 我 们 的 Repository 实 现 
会 直接 与 Spring 耦合 。 


现在 的 最 佳 实践 是 不 再 使 用 HibernateTemplate， 而 是 使 用 上 下 文 
Session (Contextual session) 。 通 过 这 种 方式 ， 会 直接 将 Hibernate 
SessionFactory 装 配 到 Repository 中 ， 并 使 用 它 来 获取 Session， 如 下 面 
的 程序 清单 所 示 。 


程序 清单 11.1 借助 Hibernate Session 实 现 不 依赖 于 Spring 的 
Repository 





public HibernateSpitterRepository(SessionFactory sessionFactory) { 


注入 


} SessionFactory 


this.sessionFactory = sessionFactory; 


private Session currentSession() { 

return sessionFactory.getCurrentSession(); 
y 从 SessionFactory 
中 获取 当前 Session 
public long count() { 

return findAll() .size(); 
} 


public Spitter savelSpitter spitter) { 
savialisablie. 3d currentSesgsion() .save (spnitter}: 
Serializable id = currentSession() .save (spitter); 使 用 当前 
return new Spitter{ (Long) id, Session 
spitter.getUsername{}, 
spitter.getPassword!(), 
spitter.getFullName{(), 
spitter.getEmail (}), 
spitter.isUpdateByEmail ()); 
} 
public Spitter findone(long id) { 
return (Spitter) currentSession() .get{Spitter.class, id); 
} 


Public Spitter findByUsername(String username) { 


return (Spitter) currer siont{) 





.CreateCriterialSpitter.class) 


.add{Restrictions.eq{("uUsername", username)) 
.list() .get(0); 


public List<Spitter> findAll{() { 
return (List<Spitter>) currentSession() 


.CreateCriterialSpitter.class)} .list{); 


} 


在 程序 清单 11.1 中 有 几 个 地 方 需 要 注意 。 首 先 ， 我 们 通过 @Inject 注 解 
让 Spring 自 动 将 一 个 SessionFactory 注 入 

到 HibernateSpitterRepository 的 sessionFactory 属 性 中 。 接 下 
来 ， 在 currentSsession() 方 法 中 ， 我 们 使 用 这 个 SessionFactory 来 
获取 当前 事务 的 Session。 


男 外 需要 注意 的 是 ， 我 们 在 类 上 使 用 了 @Repository 注 解 ， 这 会 为 我 们 
做 两 件 事情 。 首 先 ，@Repository 是 Spring 的 男 一 种 构造 性 注解 ， 它 能 
够 像 其 他 注解 一 样 被 Spring 的 组 件 扫 朱 所 扫 拉 到。 这样 就 不 必 明 确 声 

明 HibernateSpitterRepository bean 了 ， 只 要 这 个 Repository 类 在 组 
件 扫 摘 所 涵盖 的 包 中 即 可 。 


除了 帮助 减少 显 式 配置 以 外 ，@Repository 还 有 另外 一 个 用 处 。 让 我 们 
回想 一 下 模板 类 ， 它 有 一 项 任务 就 是 捕获 平台 相关 的 异常 ， 然 后 使 用 











Spring 统 一 非 检查 型 异常 的 形式 重新 抛 出 。 如 果 我 们 使 用 Hibermmate 上 下 
文 Session 而 不 是 Hibernate 模 板 的 话 ， 那 异 各 转换 会 怎么 处 理 呢 ? 


为 了 给 不 使 用 模板 的 Hibernate Repository 添 加 异常 转换 功能 ， 我 们 只 需 
在 Spring 应 用 上 下 文中 添加 一 


个 PersistenceExceptionTranslationPostProcessor bean: 


@Bean 
public BeanPostProcessor persistenceTranslation() { 


return new PersistenceExceptionTranslationpPostProcessor(); 


} 





PersistenceExceptionTranslationPostProcessor 是 一 个 bean 后 
置 处 理 右 (bean post-processor) ， 它 会 在 所 有 拥有 @Repository 注 解 的 
类 上 添加 一 个 通知 器 (advisor) ， 这 样 就 会 捕获 任何 平台 相关 的 异常 并 
以 Spring 非 检查 型 数据 访问 异常 的 形式 重新 抛 出 。 


现在 ，Hibernate 版 本 的 Repository 已 经 完成 了 。 我 们 开发 时 ， 没 有 依赖 
Spring 的 特定 类 (除了 @Repository 注 解 以 外 ) 。 这 种 不 使 用 模板 的 方 
式 也 适用 于 开发 纯粹 的 基于 JPA 的 Repository， 让 我 们 再 尝试 开发 男 一 
个 spitterRepository 实 现 类 ， 这 次 我 们 使 用 的 是 JPA。 











11.2 Spring 与 Java 持 久 化 API 


Java 持 久 化 API (Java Persistence API，JPA) 诞生 在 EJB 2 实体 Bean 的 废 
起 之 上 ， 并 成 为 下 一 代 Java 持 久 化 标准 。JPA 是 基于 POJO 的 持久 化 机 
制 ， 它 从 Hibernate 和 Java 数 据 对 象 〈Java Data Object，JDO) 上 借鉴 了 
很 多 理念 并 加 入 了 Java 5 注解 的 特性 。 


在 Spring 2.0 版 本 中 ，Spring 首 次 集成 了 JPA 的 功能 。 具 有 讽刺 意味 的 
是 ， 很 多 人 批评 〈 或 赞 人 车 ) Spring 颠 履 了 EJB。 但 是 ， 当 Spring 文 持 JPA 
后 ， 很 多 开发 人 员 都 推荐 在 基于 Spring 的 应 用 程序 中 使 用 JP 了 A 实 现 持 久 
化 。 实 际 上 ， 有 些 人 还 将 Spring-JPA 的 组 合 称 为 POJO 开 发 的 梦 之 队 。 


在 Spring 中 使 用 JPA 的 第 一 步 是 要 在 Spring 应 用 上 下 文中 将 实体 管理 帮工 
厂 《entity manager factory) 按照 bean 的 形式 来 进行 配置 。 


11.2.1 配置 实体 管理 器 工厂 


简单 来 讲 ， 基 于 JPA 的 应 用 程序 需要 使 用 EntityManagerFactory 的 实 
现 类 来 获取 EntityManager 实 例 。JPA 定 义 了 两 种 类 型 的 实体 管理 器 : 


。 应 用 程序 管理 类 型 (Application-managed) : 当 应 用 程序 向 实体 管 
理 器 工厂 直接 请 求实 体 管 理 器 时 ， 工 厂 会 创建 一 个 实体 管理 器 。 在 
这 种 模式 下 ， 程 序 要 负责 打开 或 关闭 实体 管理 器 并 在 事务 中 对 其 进 
行 控 制 。 这 种 方式 的 实体 管理 器 适合 于 不 运行 在 Java EE 容器 中 的 
独立 应 用 程序 。 

容 右 管理 类 型 (Container-managed) : 实体 管理 絮 由 Java EE 创建 
和 管理 。 应 用 程序 根本 不 与 实体 管理 器 工厂 打交道 。 相 反 ， 实 体 管 
理 器 直接 通过 注入 或 INDI 来 获取 。 容 器 负责 配置 实体 管理 器 工厂 。 
这 种 类 型 的 实体 管理 器 最 适用 于 Java EE 容器 ， 在 这 种 情况 下 会 希 
0 的 JPA 配 置 之 外 保持 一 些 自己 对 JPA 的 控 

制 。 



































以 上 的 两 种 实体 管理 器 实现 了 同一 个 EntityManager 接 口 。 关 键 的 区 别 
不 在 于 EntityManager 本 身 ， 而 是 在 于 EntityManager 的 创建 和 管理 
方式 。 应 用 程序 管理 类 型 的 EntityManager 是 

由 EntityManagerFactory 创 建 的 ， 而 后 者 是 通过 








PersistenceProvider 的 createEntityManagerFactory() 方 法 得 到 
的 。 与 此 相对 ， 容 器 管理 类 型 的 Entity ManagerFactory 是 通过 
PersistenceProvider 的 createContainerEntityManager 
Factory() 方 法 获得 的 。 


这 对 想 使 用 JPA 的 Spring 开 发 者 来 说 义 意 味 着 什么 呢 ?” 其 实 这 并 没 太 大 

的 关系 。 不 管 你 希望 使 用 哪 种 EntityManagerFactory，Spring 都 会 负 
贡 管 理 EntityManager。 如 果 你 使 用 的 是 应 用 程序 管理 类 型 的 实体 管理 
器 ，Spring 承 担 了 应 用 程序 的 角色 并 以 透明 的 方式 处 

理 EntityManager。 在 容器 管理 的 场景 下 ，Spring 会 担当 容器 的 角色 。 


这 两 种 实体 管理 器 工厂 分 别 由 对 应 的 Spring 工厂 Bean 创 建 : 


e。LocalEntityManagerFactoryBean 生 成 应 用 程序 管理 类 型 的 
EntityManager-Factory; 

e。LocalContainerEntityManagerFactoryBean 生 成 容器 管理 类 型 
的 Entity-ManagerFactory。 


需要 说 明 的 是 ， 选 择 应 用 程序 管理 类 型 的 还 是 容 髓 管理 类 型 的 
EntityManager Factory， 对 于 基于 Spring 的 应 用 程序 来 讲 是 完全 透明 
的 。 当 组 合 使 用 Spring 和 JPA 时 ， 处 理 EntityManagerFactory 的 复杂 
细节 被 隐藏 了 起 来 ， 数 据 访问 代码 只 需 关 注 它 们 的 真正 目标 即 可 ， 也 就 
是 数据 访问 。 


应 用 程序 管理 类 型 和 容器 管理 类 型 的 实体 管理 器 工厂 之 间 唯 一 值得 关注 
的 区 别 是 在 Spring 应 用 上 下 文中 如 何 进行 配置 。 让 我 们 先 看 看 如 何在 
Spring 中 配置 应 用 程序 管理 类 型 的 

LocalEntityManagerFactoryBean， 然 后 再 看 看 如 何 配置 容器 管理 类 
型 的 LocalContainerEntityManagerFactoryBean。 


配置 应 用 程序 管理 类 型 的 JPA 
对 于 应 用 程序 管理 类 型 的 实体 管理 器 工 广 来 说， 它 绝 大 部 分 配置 信息 来 


源 于 一 个 名 为 persistence.xml 的 配置 文件 。 这 个 文件 必须 位 于 类 路 径 下 
的 META-INF 目 录 下 。 


persistence.xml 的 作用 在 于 定义 一 个 或 多 个 持久 化 单元 。 持 和 久 化 单元 是 
同一 个 数据 源 下 的 一 个 或 多 个 持久 化 类 。 人 简单 来 讲 ，persistence.xml 列 















































出 了 一 个 或 多 个 的 持久 化 类 以 及 一 些 其 他 的 配置 如 数据 源 和 基于 XML 
的 配置 文件 。 如 下 是 一 个 典型 的 persistence.xml 文 件 ， 它 是 用 于 Spittr 应 
用 程序 的 : 


<persistence xmlns="http://java.sun.com/xml/ns/persistence" 
version="1.0"> 
<persistence-unit name="spitterPU"> 
<class>com.habuma.spittr.domain.Spitter</class> 
<class>com.habuma.spittr.domain.Spittle</class> 
<properties> 
<property name="toplink.jdbc.driver" 
value="org.hsqldb.jdbcDriver" /> 
<property name="toplink.jdbc.url" value= 
"jdbc:hsqldb:hsql://localhost/spitter/spitter" /> 
<property name="toplink.jdbc.user" 
value="sa" /> 
<property name="toplink.jdbc.password" 
value="" /> 
</properties> 
</persistence-unit> 
</persistence> 





因为 在 persistence.xml 文 件 中 包含 了 大 量 的 配置 信息 ， 所 以 在 Spring 中 需 
要 配置 的 就 很 少 了 。 可 以 通过 以 下 的 @Bean 注 解 方法 在 Spring 中 声 
明 LocalEntityManagerFactoryBean: 


@Bean 
public LocalEntityManagerFactoryBean entityManagerFactoryBean() { 
LocalEntityManagerFactoryBean emfb 


= new LocalEntityManagerFactoryBean( ) ; 
emfb .setPersistenceUnitName("spitterPU"”) ; 
return emfb ; 


} 





赋 给 persistenceUnitName 属 性 的 值 就 是 persistence.xml 中 持久 化 单元 
的 名 称 。 


创建 应 用 程序 管理 类 型 的 EntityManagerFactory 都 是 在 
persistence.xml 中 进行 的 ， 而 这 正 是 应 用 程序 管理 的 本 意 。 在 应 用 程序 
管理 的 场景 下 〈 不 考虑 Spring 时 ) ， 完 全 由 应 用 程序 本 身 来 负责 获取 
EntityManagerFactory， 这 是 通过 JPA 实 现 的 PersistenceProvider 
做 到 的 。 如 果 每 次 请 求 EntityManagerFactory 时 都 需要 定义 持久 化 单 

















元 ， 那 代码 将 会 迅速 膨胀 。 通 过 将 其 配置 在 persistence.xml 中 ，JPA 束 能 
够 在 这 个 特定 的 位 置 查找 持久 化 单元 定义 了 。 


但 借助 于 Spring 对 JPA 的 文 持 ， 我 们 不 再 需要 直接 处 

理 PersistenceProvider 了 。 因 此 ， 再 将 配置 信息 放 在 persistence.xml 
中 就 显得 不 那么 明智 了 。 实 际 上 ， 这 样 做 妨碍 了 我 们 在 Spring 中 本 
置 EntityManagerFactory〔 如 果 不 是 这 样 的 话 ， 我 们 可 以 提供 一 个 
Spring 配置 的 数据 源 ) 。 


鉴于 以 上 的 原因 ， 让 我 们 关注 一 下 容 需 管理 的 JPA: 
使 用 容器 管理 类 型 的 JPA 


容 吉 管理 的 JPA 采 取 了 一 个 不 同 的 方式 。 当 运行 在 容器 中 时 ， 可 以 使 用 
容 句 〈 在 我 们 的 场景 下 是 Spring) 提供 的 信息 来 生 
成 EntityManagerFactory。 


你 可 以 将 数据 源 信息 配置 在 Spring 应 用 上 下 文中 ， 而 不 是 在 
persistence.xml 中 了 。 例 如 ， 如 下 的 @Bean 注 解 方 法 声明 了 在 Spring 中 如 
何 使 用 LocalContainerEntity-ManagerFactoryBean 玉 配置 容 右 管 
理 类 型 的 JPA: 








@Bean 
public LocalContainerEntityManagerFactoryBean entityManagerFactory( 
DataSource dataSource, JpaVendorAdapter jpaVendorAdapter) { 
LocalContainerEntityManagerFactoryBean emfb = 


new LocalContainerEntityManagerFactoryBean(); 
emfb.setDataSource(dataSource); 
emfb.setJpaVendorAdapter(jpaVendorAdapter); 
return emfb; 





这 里 ， 我 们 使 用 了 Spring 配置 的 数据 源 来 设置 dataSource 属 性 。 任 
何 javax.sql.DataSource 的 实现 都 是 可 以 的 。 尽 管 数据 源 还 可 以 在 
persistence.xml 中 进行 配置 ， 但 是 这 个 属性 指定 的 数据 源 具 有 更 高 的 优 
先 级 。 


jpaVendorAdapter 属 性 用 于 指明 所 使 用 的 是 哪 一 个 厂商 的 JPA 实 现 。 
Spring 提供 了 多 个 JPA 广 商 适 配 髓 : 





e。 EclipseLinkJpaVendorAdapter 

。 HibernateJpavendorAdapter 

e。 OpenJpavendorAdaptenr 

。TopLinkJpaVendorAdapter (在 Spring 3.1 版 本 中 ， 已 经 将 其 废弃 
了) 


在 本 例 中 ， 我 们 使 用 Hibernate 作 为 JPA 实 现 ， 所 以 将 其 配置 
为 Hibernate-JpaVendorAdapter: 


@Bean 
public JpaVendorAdapter jpaVendorAdapter() { 


HibernateJpavendorAdapter adapter = new HibernateJpaVendorAdapter(); 
adapter .setDatabase("HSQL"); 
adapter .setShowSql(true); 


adapter .setGenerateDdl(false); 


adapter.setDatabasePlatform("org.hibernate.dialect.HSQLDialect"); 
return adapter; 











有 多 个 属性 需要 设置 到 厂商 适配器 上 ， 但 是 最 重要 的 是 database 属 
性 ， 在 上 面 我 们 设置 了 要 使 用 的 数据 库 是 Hypersonic。 这 个 属性 支持 的 
其 他 值 如 表 11.1 所 示 。 


表 11.1 ” Hibernate 的 JPA 适 配器 支持 多 种 数据 库 ， 可 以 通过 其 database 属 性 配置 使 用 哪个 数据 


库 























Informix INFORMIX 


MySQL MYSQL 


PostgresQL POSTGRESQL 
Microsoft SQL Server SQLSERVER 
Sybase SYBASE 


一 些 特定 的 动态 持久 化 功能 需要 对 持久 化 类 按照 指令 

(instrumentation〉 进行 修改 才能 文 持 。 在 属性 延迟 加 载 “〈 只 在 它们 被 
实际 访问 时 才 从 数据 库 中 获取 ) 的 对 象 中 ， 必 须要 包含 知道 如 何 查询 未 
加 载 数 据 的 代码 。 一 些 框架 使 用 动态 代理 实现 延迟 加 载 ， 而 有 一 些 框架 
像 JDO， 则 是 在 编译 时 执行 类 指令 。 


选择 哪 一 种 实体 管理 器 工厂 主要 取决 于 如 何 使 用 它 。 但 是 ， 下 面 的 小 技 
巧 可 能 会 让 你 更 加 倾向 于 使 


用 LocalContainerEntityManagerFactoryBean。 


persistence.xml 文 件 的 主要 作用 束 在 于 识别 持久 化 单元 中 的 实体 类 。 但 
是 从 Spring 3.1 开 始 ， 我 们 能 够 

在 LocalContainerEntityManagerFactoryBean 中 直接 设 

置 packagesToScan 属 性 : 








@Bean 
public LocalContainerEntityManagerFactoryBean entityManagerFactory( 
DataSource dataSource, JpaVendorAdapter jpaVendorAdapter) { 
LocalContainerEntityManagerFactoryBean emfb = 
new LocalContainerEntityManagerFactoryBean(); 


emfb.setDataSource(dataSource); 
emfb.setJpaVendorAdapter(jpaVendorAdapter); 
emfb.setpackagesToScan("com.habuma.spittr.domain"); 
return emfb; 





在 这 个 配置 中 ，LocalContainerEntityManagerFactoryBean 会 扫描 
com.habuma.spittr.domain 包 ， 查 找 带 有 @Entity 注 解 的 类 。 因 此 ， 

没有 必要 在 persistence.xml 文 件 中 进行 声明 了 。 同 时 ， 因 为 DataSource 
也 是 注入 到 LocalContainer-EntityManager FactoryBean 中 的 ， 所 
以 也 没有 必要 在 persistence.xml 文 件 中 配置 数据 库 信 息 了 。 那 么 结论 就 

是 ，persistence.xml 文 件 完全 没有 必要 存在 了 ! 你 尽 可 以 将 其 删除 ， 让 

LocalContainerEntityManagerFactoryBean 来 处 理 这 些 事情 。 


从 JNDI 获 取 实 体 管 理 器 工厂 
还 有 一 件 需要 注意 的 事项 ， 如 果 将 Spring 应 用 程序 部 署 在 应 用 服务 堪 


中 ，EntityManagerFactory 可 能 已 经 创建 好 了 并 且 位 于 JNDI 中 等 待 查 
询 使 用 。 在 这 种 情况 下 ， 可 以 使 用 Spring jee 命 名 空间 下 的 <jee:jndi- 

















lookup> 元 素来 获取 对 EntityManagerFactory 的 引用 : 





<jee:jndi-lookup id="emf" jndi-name="persistence/spitterpPU" /> 


我 们 也 可 以 使 用 如 下 的 Java 配 置 来 获取 EntityManagerFactory: 


@Bean 
public JndiobJjectFactoryBean entityManagerFactory() {} 
JndiObjectFactoryBean jndiObjectFB = new JndiObjectFactoryBean(); 


jndiObjectFB.setJndiName("jdbc/SpittrDS"); 
return jndiObjectFB; 
} 





尽管 这 种 方法 没有 返回 EntityManagerFactory， 但 是 它 的 结果 就 是 一 
个 EntityManagerFactory bean。 这 是 因为 它 所 返回 的 
JndiObjectFactoryBean 是 FactoryBean 接 口 的 实现 ， 它 能 够 创建 
EntityManagerFactory。 


不 管 你 采用 何 种 方式 得 到 EntityManagerFactory， 一 旦 得 到 这 样 的 对 
象 ， 接 下 来 就 可 以 编写 Repository 了 。 让 我 们 开始 吧 。 


11.2.2 ”编写 基于 JPA 的 Repository 
正如 Spring 对 其 他 持久 化 方案 的 集成 一 样 ，Spring 对 JPA 集 成 也 提供 了 


JpaTemp1late 模 板 以 及 对 应 的 支持 类 JpaDaoSsupport。 但 是 ， 为 了 实现 
更 纯粹 的 JPA 方 式 ， 基 于 模板 的 JPA 已 经 被 弃 用 了 。 这 与 我 们 在 11.1.2 小 








节 使 用 的 Hibernate 上 下 文 Session 是 很 类 似 的 。 


鉴于 纯粹 的 JPA 方 式 远 胜 于 基于 模板 的 PA， 所 以 在 本 节 中 我 们 将 会 重 
点 关注 如 何 构建 不 依赖 Spring 的 JPA Repository。 如 下 程序 清单 中 的 
JpaSspitterRepository 展 现 了 如 何 开发 不 使 用 Spring JpaTemplate 的 
JPA Repository。 


程序 清单 11.2 ”不 使 用 Spring 模板 的 纯 JPA Repository 


package com.habuma.spittr.persistence; 


import java.util.List; 
上 







ao.DataAccessException; 


ort org.springfram 





tereotype.Repository; 


t org.spri on.annotation.Transactional; 





ort com.habuma.spittr.do 





ort com.habuma.spittr.domai 





@Transa D 
Public class 





Repository implements SpitterRepository { 


PersistenceUnit 注入 
private EntityManagerFactory emf; < EntityManagerFactory 


public void addSspitter(Spitter spitter) { 

emf .createEntityManager() .persist (spitter); < 创建 并 使 用 
EntityManager 
public Spitter getSpitterById(long id) { 
return emf.createEntityManager() .find(Spitter.class, id); 





public void saveSpitter(Spitter spitter) { 
emf .createEntityManager() .mergelspitter);: 
} 


程序 清单 11.2 中 ， 需 要 注意 的 是 EntityManagerFactory 属 性 ， 它 使 用 
了 @PersistenceUnit 注 解 ， 因 此 ，Spring 会 

将 EntityManagerFactory 注 入 到 Repository 之 中 。 有 了 
EntityManagerFactory 之 后 ，JpaSpitterRepository 的 方法 就 能 使 
用 它 来 创建 EntityManager 了 ， 然 后 EntityManager 可 以 针对 数据 库 
执行 操作 。 


在 JpaSpitterRepository 中 ， 唯 一 的 问题 在 于 每 个 方法 都 会 调 

用 createEntityManager()。 除 了 引入 易 出 错 的 重复 代码 以 外 ， 这 还 
意味 着 每 次 调用 Repository 的 方法 时 ， 都 会 创建 一 个 新 的 
EntityManager。 这 种 复杂 性 源 于 事务 。 如 有 果 我 们 能 够 预先 准备 





好 EntityManager， 屠 会 不 会 更 加 方便 呢 ? 


这 里 的 问题 在 于 EntityManager 并 不 是 线程 安全 的 ， 一 般 来 讲 并 不 适合 
注入 到 像 Repository 这 样 共享 的 单 例 bean 中 。 但 是 ， 这 并 不 意味 着 我 们 
没有 办 法 要 求 注入 EntityManager。 如 下 的 程序 清单 展现 了 如 何 借 助 
@PersistentContext 注 解 为 JpaSpitterRepository 设 

置 EntityManager。 


程序 清单 11.3” 将 EntityManager 的 代理 注入 到 Repository 之 中 





t org.springframework.stereot 
import org.springframework.transaction.annotation.Transactional; 
import com.habuma.spittr.domain.spitter; 


import com.habuma.spittr.domain.Spittle; 


nsactional 





lass JpaSpitterRepository implements SpitterRepository 


@PersistenceContext 
private EntityManager em; < 注入 EntityManager 
public void addspitter(Spitter spitter) { 


em.persist {spitter); < 使 用 EntityManager 


Public Spitter getSpitterById(long iQ) { 


return em.findlSpitter.class, id); 


public void saveSpitter(Spitter spitter) { 


se 
在 这 个 新 版 本 的 JjpaSpitterRepository 中 ， 直 接 为 其 设置 了 
EntityManager， 这 样 的 话 ， 在 每 个 方法 中 就 没有 必要 再 通过 


EntityManagerFactory 创 建 EntityManager 了 。 尽 管 这 种 方式 非常 便 
利 ， 但 是 你 可 能 会 担心 注入 的 EntityManager 会 有 线程 安全 性 的 问题 。 





这 里 的 真相 是 @PersistenceContext 并 不 会 真正 注入 EntityManager 
一 一 至 少 ， 精 确 来 讲 不 是 这 样 的 。 它 没 有 将 真正 的 EntityManager 设 置 
给 Repository， 而 是 给 了 它 一 个 EntityManager 的 代理 。 真 正 的 
EntityManager 是 与 当前 事务 相关 联 的 那 一 个 ， 如 果 不 存在 这 样 的 
EntityManager 的 话 ， 束 会 创建 一 个 新 的 。 这 样 的 话 ， 我 们 就 能 始终 以 





线程 安全 的 方式 使 用 实体 管理 喜 。 


另外 ， 还 需要 了 解 @PersistenceUnit 和 @PersistenceContext 并 不 
是 Spring 的 注解 ， 它 们 是 由 JPA 规 范 提供 的 。 为 了 让 Spring 理 解 这 些 注 
解 ， 并 注入 EntityManager Factory 或 EntityManager， 我 们 必须 要 
配置 Spring 的 Persistence-AnnotationBeanPostProcessor。 如 果 你 
已 经 使 用 了 <context :annotation-configy> 

或 <context :component-scan>， 那 么 你 就 不 必 再 担心 了 ， 因 为 这 些 配 
置 元 素 会 目 动 注册 PersistenceAnnotationBeanPostProcessor 
bean。 人 否则 的 话 ， 我 们 需要 显 式 地 注册 这 个 bean; 


@Bean 
public PersistenceAnnotationBeanPostProcessor paPostProcessor() { 


return new PersistenceAnnotationBeanpostProcessor(); 


} 





你 可 能 也 注意 到 了 JpaspitterRepository 使 用 了 Q@Repository 和 
@Transactional 注 解 。@Transactional 表 明 这 个 Repository 中 的 持久 
化 方法 是 在 事务 上 下 文中 执行 的 。 


对 于 @Repository 注 解 ， 它 的 作用 与 开发 Hibernate 上 下 文 Session 版 本 的 
Repository 时 是 一 致 的 。 由 于 没有 使 用 模板 类 来 处 理 异 常 ， 所 以 我 们 需 
要 为 Repository 添 加 @Repository 注 解 ， 这 

样 PersistenceExceptionTranslationPostProcessor 就 会 知道 要 将 
这 个 bean 产 生 的 异常 转换 成 Spring 的 统一 数据 访问 异常 。 


既然 提 到 了 PersistenceExceptionTranslationPostProcessor， 要 
记 住 的 是 我 们 需要 将 其 作为 一 个 bean 装 配 到 Spring 中 ， 就 像 我 们 在 
Hibernate 样 例 中 所 做 的 那样 : 


@Bean 
public BeanPostProcessor persistenceTranslation() { 


return new PersistenceExceptionTranslationpPostProcessor(); 


} 





提醒 一 下 ， 不 管 对 于 JPA 还 是 Hibernate， 异 党 转换 都 不 是 强制 要 求 的 。 
如 果 你 希望 在 Repository 中 抛 出 特定 的 JPA 或 Hibernate 异 常 ， 只 需 
将 PersistenceException-TranslationPostProcessor 省 略 掉 即 


可 ， 这 样 原 来 的 异常 就 会 正常 地 处 理 。 但 是 ， 如 果 使 用 了 Spring 的 异常 





转换 ， 你 会 将 所 有 的 数据 访问 异常 置 于 Spring 的 体系 之 下 ， 这 样 以 后 切 
换 持久 化 机 制 的 话 会 更 容易 。 


11.3 ”借助 Spring Data 实 现 自动 化 的 JPA 
Repository 


尽管 程序 清单 11.2 和 11.3 程 序 清单 中 的 方法 都 很 简单 ， 但 它们 依然 还 会 
直接 与 EntityManager 交 互 来 查询 数据 库 。 并 且 ， 人 和 仔细 看 一 下 的 话 ， 这 
A 例如 ， 让 我 们 重新 审视 addSpitter() 方 

法 : 


public void addSpitter(Spitter spitter) { 
entityManager.persist(spitter); 


} 


在 任何 具有 一 定 规 模 的 应 用 中 ， 你 可 能 会 以 几乎 完全 相同 的 方式 多 次 编 
写 这 种 方法 。 实 际 上 ， 除 了 所 持久 化 的 Spitter 对 象 不 同 以 外 ， 我 敢 打 
赌 你 以 前 肯定 写 过 类 似 的 方法 。 其 实 ，JpaSpitterRepository 中 的 其 
他 方法 也 没有 什么 太 大 的 创造 性 。 领 域 对 象 会 有 所 不 同 ， 但 是 所 有 
Repository 中 的 方法 都 是 很 通用 的 。 


为 什么 我 们 需要 一 过 遇 地 编写 相同 的 持久 化 方法 呢 ， 难 道 仅 仅 是 因为 要 
处 理 的 领域 类 型 不 同 吗 ? Spring Data JPA 能 够 终结 这 种 样板 式 的 愚 春 行 
为 。 我 们 不 再 需要 一 裔 遍地 编写 相同 的 Repository 实 现 ，Spring Data 能 够 
让 我 们 只 编写 Repository 接 口 束 可 以 了 。 根 本 束 不 再 需要 实现 类 了 。 
例如 ， 看 一 下 SpitterRepository 接 口 。 


程序 清单 11.4 借助 Spring Data， 以 接口 定义 的 方式 创建 Repository 




















public interface SpitterRepository 
extends JpaRepository<Spitter, Long> { 
} 


此 时 ，SpitterRepository 看 上 去 并 没有 什么 作用 。 但 是 ， 它 的 功能 
远 超出 了 表面 上 所 看 到 的 那样 。 


编写 Spring Data JPA Repository 的 关键 在 于 要 从 一 组 接口 中 挑选 一 个 进 
行 扩 展 。 这 里 ，SpitterRepository 扩 展 了 Spring Data JPA 的 





]paRepository《〈 稍 后 ， 我 会 介绍 几 个 其 他 的 接口 ) 。 通 过 这 种 方 

式 ，JpaRepository 进 行 了 参数 化 ， 所 以 它 就 能 知道 这 是 一 个 用 来 持久 
化 Spitter 对 象 的 Repository， 并 且 Spitter 的 ID 类 型 为 Long。 另 外 ， 
它 还 会 继承 18 个 执行 持久 化 操作 的 通用 方法 ， 如 保存 spitter、 删 

除 Spitter 以 及 根据 ID 得 询 Spitter。 


此 时 ， 你 可 能 会 想 下 一 步 就 该 编写 一 个 类 实现 SpitterRepository 和 
它 的 18 个 方法 了 。 如 果真 的 是 这 样 的 话 ， 那 本 章 就 会 变 得 乏味 无 聊 了 。 
其 实 ， 我 们 根本 不 需要 编写 SpitterRepository 的 任何 实现 类 ， 相 
反 ， 我 们 让 Spring Data 来 为 我 们 做 这 件 事 请 。 我 们 所 需要 做 的 就 是 对 它 
提出 要 求 。 


为 了 要 求 Spring Data 创 建 SpitterRepository 的 实现 ， 我 们 需要 在 
Spring 配置 中 添加 一 个 元 素 。 如 下 的 程序 清单 展现 了 在 XML 配置 中 局 用 
Spring Data JPA 所 需要 添加 的 内 容 : 














程序 清单 11.5 配置 Spring Data JPA 


<?xml version="1.6” encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:jpa="http://www.springframework.org/schema/data/jpa" 
xsi:schemaLocation="http://www.springframework.org/schema/data/jpa 
http://www.springframework.org/schema/data/jpa/spring-jpa-1.60.xsd"> 


<jpa:repositories base-package="com.habuma.spittr.db" /> 


</beans> 





<jpa:repositories> 元 素 掌 握 了 Spring Data JPA 的 所 有 魔力 。 就 俐 
<context:component-scan> 元 素 一 样 ，<jpa:repositories> 元 素 也 
需要 指定 一 个 要 进行 扫描 的 base-package。 不 

过 ,， “context:component-scan> 会 扫描 包 《〈 及 其 子 包 ) 来 查找 这 

有 @Component 注 解 的 类 ， 而 <jpa:repositories> 会 扫描 它 的 基础 包 
来 查找 扩展 自 Spring Data JPA Repository 接 口 的 所 有 接口 。 如 果 发 现 
了 扩展 自 Repository 的 接口 ， 它 会 自动 生成 在 应 用 启动 的 时 候 ) 这 
个 接口 的 实现 。 














如 果 要 使 用 Java 配 置 的 话 ， 那 就 不 需要 使 用 <jpa: repositories> 元 叉 
了 ， 而 是 要 在 Java 配 置 类 上 添加 @EnableJpaRepositories 注 解 。 如 下 
就 是 一 个 Java 配 置 类 ， 它 使 用 了 @EnableJpaRepositories 注 解 ， 并 且 
会 扫描 com.habuma.spittr.db 包 : 


@Configuration 
@EnableJpaRepositories(basePpackages="com.habuma.spittr.db") 


public class JpaConfiguration { 





} 





让 我 们 回 到 spitterRepository 接 口 ， 它 扩展 自 J]paRepository， 

而 JpaRepository 义 扩展 自 Repository 标 记 接 口 (虽然 是 间接 的 ) 。 

此 ，SpitterRepository 就 传递 性 地 扩展 了 Repository 接 口 ， 也 就 是 
Repository 扫 描 时 所 要 查找 的 接口 。 当 Spring Data 找 到 它 后 ， 就 会 创建 

SpitterRepository 的 实现 类 ， 其 中 包含 了 继承 自 

JpaRepository、 PagingAndSortingRepository 和 CrudRepository 
的 18 个 方法 。 


很 重要 的 一 点 在 于 Repository 的 实现 类 是 在 应 用 局 动 的 时 候 生 成 的 ， 也 
就 是 Spring 的 应 用 上 下 文 创建 的 时 候 。 它 并 不 是 在 构建 时 通过 代码 生成 
技术 产生 的 ， 也 不 是 接口 方法 调用 时 才 创 建 的 。 


很 漂亮 的 技术 ， 对 吧 ? 


Spring Data JPA 很 棒 的 一 点 在 于 它 能 为 Spitter 对 象 提供 18 个 便利 的 方 
法 来 进行 通用 的 JPA 操 作 ， 而 无 需 你 编写 任何 持久 化 代码 。 但 是 ， 如 果 
你 的 需求 超过 了 它 所 提供 的 这 18 个 方法 的 话 ， 该 怎么 办 呢 ? 幸好 ， 
Spring Data JPA 提 供 了 几 种 方式 来 为 Repository 添 加 目 定 义 的 方法 。 让 我 
们 看 一 下 如 何 为 Spring Data JPA 编 写 自 定义 的 查询 方法 。 














11.3.1 定义 得 询 方法 
现在 ，SpitterRepository 需 要 完成 的 一 项 功能 是 根据 给 定 的 username 


查找 Spitter 对 象 。 比 如 ， 我 们 将 SpitterRepository 接 口 修改 为 如 下 
所 示 的 样子 : 


public interface SpitterRepository 
extends JpaRepository<Spitter, Long> { 


Spitter findByUsername(String username ) ; 
} 


这 个 新 的 findByUserName( ) 非 常 简单 ， 但 是 足以 满足 我 们 的 需求 。 现 
在 ， 该 如 何 让 Spring Data JPA 提 供 这 个 方法 的 实现 呢 ? 


实际 上 ， 我 们 并 不 需要 实现 findByUsername() 。 方 法 签名 已 经 告诉 
Spring Data JPA 足 够 的 信息 来 创建 这 个 方法 的 实现 了 。 


当 创建 Repository 实 现 的 时 候 ，Spring Data 会 检查 Repository 接 口 的 所 有 
方法 ， 解 析 方 法 的 名 称 ， 并 基于 被 持久 化 的 对 象 来 试图 推测 方法 的 目 
的 。 本 质 上 ，Spring Data 定 义 了 一 组 小 型 的 领域 特定 语言 domain- 
Specific language ，DSL) ， 在 这 里 ， 持 久 化 的 细节 都 是 通过 Repository 
方法 的 签名 来 描述 的 。 


Spring Data 能 够 知道 这 个 方法 是 要 查找 spitter 的 ， 因 为 我 们 使 

用 Spitter 对 JpaRepository 进 行 了 参数 化 。 方 法 名 findByUsername 
确定 该 方法 需要 根据 username 属 性 相 匹 配 来 查找 Spitter， 

而 username 是 作为 参数 传递 到 方法 中 来 的 。 另 外 ， 因 为 在 方法 签名 中 
定义 了 该 方法 要 返回 一 个 Spitter 对 象 ， 而 不 是 一 个 集合 ， 因 此 它 只 会 
查找 一 个 username 属 性 匹配 的 Spitter。 








findByUsername() 方 法 非常 简单 ， 但 是 Spring Data 也 能 处 理 更 加 有 意 
思 的 方法 名 称 。Repository 方 法 是 由 一 个 动词 、 一 个 可 选 的 主题 
(CSubject) 、 关 键 词 By 以 及 一 个 断言 所 组 成 。 在 findByUsername() 这 
个 样 例 中 ， 动 词 是 hnd， 上 断言 是 Username， 主 题 并 没有 指定 ， 暗 含 的 主 
题 是 Spitter。 


作为 编写 Repository 方 法 名 称 的 样 例 ， 我 们 参照 名 
为 readSpitterByFirstname-OrLastname() 的 方法 ， 看 一 下 方法 中 
的 各 个 部 分 是 如 何 映射 的 。 图 11.1 展 现 了 这 个 方法 是 如 何 拆 分 的 。 


我 们 可 以 看 到 ， 这 里 的 动词 是 reaqd， 与 之 前 样 例 中 的 find 有 所 差别 。 
Spring Data 人 允许 在 方法 名 中 使 用 四 种 动词 : get、read、find 和 count。 其 
中 ， 动 词 get、read 和 jind 是 同 义 的 ， 这 三 个 动词 对 应 的 Repository 方 法 都 
而 动词 count 则 会 返回 匹配 对 象 的 数量 ， 而 不 
是 对 i 











查询 动词 断言 
Wd | | 
readSpitterByFirstnameOrLastnameOrderByLastname ( ) 


主题 


图 11.1 Repository 方 法 的 命名 遵循 一 种 模式 ， 有 助 于 Spring Data 
生成 针对 数据 库 的 查询 


Repository 方 法 的 主题 是 可 选 的 。 它 的 主要 目的 是 让 你 在 命名 方法 的 时 
候 ， 有 更 多 的 灵活 性 。 如 果 你 更 愿意 将 方法 称 

为 readSpittersByFirstnameOrLastname() 而 不 是 
readByFirstnameOrLastname() 的 话 ， 那 么 你 尽 可 以 这 么 做 。 


对 于 大 部 分 场景 来 说 ， 主 题 会 被 省 略 

掉 。readSpittersByFirstnameOrLastname() 

与 readPuppiesByFirstnameOrLastname() 并 没有 什么 差别 ， 它 们 
与 readThose ThingsWeWantByFirstnameOrLastname() 同 样 没 有 什 
么 区 别 。 要 查询 的 对 象 类 型 是 通过 如 何 参 数 化 JpaRepository 接 口 来 确定 
的 ， 而 不 是 方法 名 称 中 的 主题 。 


在 省 略 主题 的 时 候 ， 有 一 种 例外 情况 。 如 有 果 主 题 的 名 称 以 Distinct 开 头 的 
话 ， 那 么 在 生成 得 询 的 时 候 会 确保 所 返回 结果 集中 不 包含 重复 记录 。 


呆 言 是 方法 名 称 中 最 为 有 意思 的 部 分 ， 它 指定 了 限制 结果 集 的 属性 。 
在 readByFirstnameOrLastname() 这 个 样 例 中 ， 会 通过 firstname 属 
性 或 1astname 属 性 的 值 来 限制 结果 。 


在 断言 中 ， 会 有 一 个 或 多 个 限制 结果 的 条 件 。 每 个 条 件 必须 引用 一 个 属 
性 ， 并 且 还 可 以 指定 一 种 比较 操作 。 如 果 省 略 比较 操作 符 的 话 ， 那 么 这 
暗 指 是 一 种 相等 比较 操作 。 不 过 ， 我 们 也 可 以 选择 其 他 的 比较 操作 ， 包 
括 如 下 的 种 类 : 


IsAfter、 After、IsGreaterThan、GreaterThan 
IsGreaterThanEtqual、GreaterThanEqual 
IsBefore、 Before、IsLessThan、LessThan 
IsLessThanEqual、LessThanEqual 

IsBetween、 Between 

IsNull、 Null 




















IsNotNull、 NotNull 

IsIn、 In 

IsNotIn、 NotIn 

IsStartingWith、 StartingWith、StartsWith 
IsEndingWith、EndingWith、EndsWith 
IsContaining、 Containing、Contains 
IsLike、 Like 

IsNotLike、 NotLike 

IsTrue、 True 

IsFalse、 False 

Is、Equals 

IsNot、 Not 


要 对 比 的 属性 值 就 是 方法 的 参数 。 完 整 的 方法 签名 如 下 所 示 : 


List<Spitter> readByFirstnameOrLastname(String first, String last) 


要 处 理 String 类 型 的 属性 时 ， 条 件 中 可 能 还 会 包含 IfgnoringCase 

或 TgnoresCase， 这 样 在 执行 对 比 的 时 候 就 会 不 再 考虑 字符 是 大 写 还 是 
小 写 。 例 如 ， 要 在 firstname 和 1astname 属 性 上 和 忽略 大 小 写 ， 那 么 可 
以 将 方法 签名 改 成 如 下 的 形式 : 


List<Spitter> readByFirstnameIgnoringCaseOrLastnameIgnoresCase( 
String first, String last); 


需要 注意 ，IgnoringCase 和 IgnoresCase 是 同 义 的 ， 你 可 以 随意 挑选 








作为 IgnoringCase/IgnoresCase 的 替代 方案 ， 我 们 还 可 以 在 所 有 条 件 
的 后 面 添加 ALLIgnoringCase 或 ALL1IgnoresCase， 这 样 它 就 会 忽略 所 
有 条 件 的 大 小 写 : 


List<Spitter> readByFirstnameOrLastnameAllIgnoresCasel( 
String first, String last); 


注意 ， 参 数 的 名 称 是 无 关 紧 要 的 ， 但 是 它们 的 顺序 必须 要 与 方法 名 称 中 
的 操作 符 相 匹配 。 





最 后 ， 我 们 还 可 以 在 方法 名 称 的 结尾 处 添加 OrderBy， 实 现 结果 集 排 
序 。 例 如 ， 我 们 可 以 按照 lastname 属 性 升序 排列 结果 集 : 


List<Spitter> readByFirstnameOrLastnameOrderByLastnameAsc( 
String first, String last); 


如 果 要 根据 多 个 属性 排序 的 话 ， 只 需 将 其 依 序 添加 到 OrderBy 中 即 可 。 
例如 ， 下 面 的 样 例 中 ， 首 先 会 根据 lastname 升 序 排列 ， 然 后 根 
据 firstname 属 性 降序 排列 : 


List<Spitter> readByFirstnameOrLastnameOrderByLastnameAscFirstnameDesc( 
String first, String last); 


可 以 看 到 ， 条 件 部 分 是 通过 And 或 者 Or 进行 分 割 的 。 


我 们 不 可 能 《至 少 很 难 ) 提供 一 个 权威 的 列表 ， 将 使 用 Spring Data 方 法 
命名 约定 可 以 编写 出 来 的 方法 种 类 全 部 列 出 来 。 但 是 ， 如 下 给 出 了 几 个 
符合 方法 命名 约定 的 方法 签名 : 


e List<Pet> findPetsByBreedIn(List<String> breed ) 

e int countProductsByDiscontinuedTrue( ) 

e List<Order> findByShippingDateBetween(Date start, 
Date end) 


我 们 只 是 初步 体验 了 所 能 声明 的 方法 种 类 ，Spring Data JPA 会 为 我 们 实 
现 这 些 方法 。 现 在 ， 我 们 只 需 知 道 通过 使 用 属性 名 和 关键 字 构建 
Repository 方 法 签名 ， 就 能 让 Spring Data JPA 生 成 方法 实现 ， 完 成 几乎 所 
有 能 够 想象 到 的 查询 。 


不 过 ，Spring Data 这 个 小 型 的 DSL 依 旧 有 其 局 限 性 ， 有 时候 通过 方法 名 
称 表 达 预 期 的 查询 很 烦琐 ， 甚 至 无 法 实现 。 如 果 遇 到 这 种 情形 的 话 ， 
Spring Data 能 够 让 我 们 通过 @Query 注 解 来 解决 问题 。 


11.3.2 声明 自 定义 查询 
假设 我 们 想 要 创建 一 个 Repository 方 法 ， 用 来 查找 E-mail 地 址 是 Gmail 邮 


箱 的 Spitter。 有 一 种 方式 束 是 定义 一 个 findByEmailLike() 方 法 ， 然 
后 每 次 想 查 找 Gmail 用 户 的 时 候 束 将 “%gmail.com” 传 递 进来 。 不 过 ， 更 











好 的 方案 是 定义 一 个 更 加 便利 的 findAllGmailspitters() 方 法 ， 这 样 
的 话 ， 就 不 用 将 Email 地 址 的 一 部 分 传递 进来 了 : 


List<Spitter> findAllGmailSpitters(); 


不 过 ， 这 个 方法 并 不 符合 Spring Data 的 方法 命名 约定 。 当 Spring Data 试 
图 生成 这 个 方法 的 实现 时 ， 无 法 将 方法 名 的 内 容 与 Spitter 元 模型 进行 匹 
配 ， 因 此 会 抛 出 异常。 


如 果 所 需 的 数据 无 法 通过 方法 名 称 进 行 恰当 地 描述 ， 那 么 我 们 可 以 使 
用 @Query 注 解 ， 为 Spring Data 提 供 要 执行 的 查询 。 对 于 
findAllGmailSpitters() 方 法 ， 我 们 可 以 按照 如 下 的 方式 来 使 

用 @Query 注 解 : 





@Query("select s from Spitter s where s.email like '%gmail.com'") 





List<Spitter> findAllGmailSpitters(); 


我 们 依然 不 需要 编写 findA11Gmailspitters() 方 法 的 实现 ， 只 需 提供 
查询 即 可 ， 让 Spring Data JPA 知 道 如 何 实现 这 个 方法 。 


可 以 看 到 ， 当 使 用 方法 命名 约定 很 难 表达 预期 的 查询 时 ，@Query 注 解 
能 够 用 挥 作 用 。 如 果 按 照 命名 约定 ， 方 法 的 名 称 特别 长 的 时 候 ， 也 可 以 
使 用 这 个 注解 。 例 如 ， 考 虑 如 下 的 查询 方法 : 


List<Order> 
findByCustomerAddressZipCodeOrCustomerNameAndCustomerAddressState(); 


这 真 的 是 一 个 方法 的 名 称 ! 我 不 得 不 在 返回 类 型 后 将 其 断 开 ， 这 样 才 能 
适应 本 书页 面 的 宽度 。 


我 承认 这 是 一 个 有 点 牵强 的 例子 。 但 在 现实 世界 中 ， 确 实 存在 这 样 的 需 
求 ， 使 用 Repository 方 法 所 执行 的 查询 会 得 到 一 个 很 长 的 方法 名 。 在 这 
种 情况 下 ， 你 最 好 使 用 一 个 较 短 的 方法 名 ， 并 使 用 QQuery 来 指定 该 方 
法 要 如 何 查 询 数据 库 。 


对 于 Spring Data JPA 的 接口 来 说 ，@Query 是 一 种 添加 自 定 义 查 询 的 便利 
方式 。 但 是 ， 它 仅 限 于 单个 JPA 查 询 。 如 果 我 们 需要 更 为 复杂 的 功能 ， 
无 法 在 一 个 简单 的 查询 中 处 理 的 话 ， 该 怎么 办 呢 ? 























11.3.3 ”混合 自 定 义 的 功能 


有 些 时 候 ， 我 们 需要 Repository 所 提供 的 功能 是 无 法 用 Spring Data 的 方法 
命名 约定 来 描述 的 ， 甚 至 无 法 用 @Query 注 解 设置 查询 来 实现 。 尽 管 
Spring Data JPA 非 常 棒 ， 但 是 它 依然 有 其 局 限 性 ， 可 能 需要 我 们 按照 传 
统 的 方式 来 编写 Repository 方 法 : 也 就 是 直接 使 用 EntityManager。 妆 
遇 到 这 种 情况 的 时 候 ， 我 们 是 不 是 要 放弃 Spring Data JPA， 重 新 按照 
11.2.2 小 节 中 的 方式 来 编写 Repository 呢 ? 


简单 来 说 ， 是 这 样 的 。 如 果 你 需要 做 的 事情 无 法 通过 Spring Data JPA 来 
实现 ， 那 惑 必 须要 在 一 个 比 Spring Data JPA 更 低 的 层级 上 使 用 JPA。 好 
消息 是 我 们 没有 必要 完全 放弃 Spring Data JPA。 我 们 只 需 在 必须 使 用 较 
低层 级 JPA 的 方法 上 ， 才 使 用 这 种 传统 的 方式 即 可 ， 而 对 于 Spring Data 
JPA 知 道 该 如 何 处 理 的 功能 ， 我 们 依然 可 以 通过 它 来 实现 。 


当 Spring Data JPA 为 Repository 接 口 生成 实现 的 时 候 ， 它 还 会 查找 名 字 与 
接口 相同 ， 并 且 添 加 了 Impl 后 级 的 一 个 类 。 如 果 这 个 类 存在 的 话 ， 
Spring Data JPA 将 会 把 它 的 方法 与 Spring Data JPA 所 生成 的 方法 合并 在 
一 起 。 对 于 SpitterRepository 接 口 而 言 ， 要 查找 的 类 名 

为 SpitterRepositoryImpl。 

















为 了 阐述 该 功能 ， 假 设 我 们 需要 在 SpitterRepository 中 添加 一 个 方 
法 ， 发 表 Spitt1le 数 量 在 10,000 及 以 上 的 Spitter 将 会 更 新 为 Elite 状 
态 。 使 用 Spring Data JPA 的 方法 命名 约定 或 使 用 QQuery 均 没有 办 法 声明 
这 样 的 方法 。 最 为 可 行 的 方案 是 使 用 如 下 的 eliteSsweep() 方 法 。 


程序 清单 11.6 ”将 活跃 的 Spitter 用 户 升 级 为 Elite 状 态 的 Repository 方 法 








public class SpitterRepositoryImpl implements SpitterSweeper { 


@PersistenceContext 
private EntityManager em; 


public int eliteSweep() { 
String update = 
"UPDATE Spitter spitter " + 
"SET spitter.status = 'Elite' " + 
"WHERE spitter.status = 'Newbie' " + 
"AND spitter.id IN (" + 
"SELECT s FROM Spitter s WHERE ("+ 


SELECT COUNT(spittles) FROM s.spittles spittles) > 1660606” + 
0 
Peturn em.createQuery(update) .executeUpdate() ; 
} 
} 








我 们 可 以 看 到 ，eliteSweep() 方 法 与 之 前 在 11.2.2 小 节 中 所 创建 的 
Repository 方 法 并 没有 太 大 的 差别 。SpitterRepositoryImpl 没 有 什么 
特殊 之 处 ， 它 使 用 被 注入 的 EntityManager 来 完成 预期 的 任务 。 


注意 ，SpitterRepositoryImpl 并 没有 实现 SpitterRepository 接 
口 。Spring Data JPA 负 责 实现 这 个 接 

口 。SpitterRepositoryImpl (将 它 与 Spring Data 的 Repository 关 联 起 
来 的 是 它 的 名 字 ) 实现 了 SpitterSweeper 接 口 ， 它 如 下 所 示 : 





public interface SpitterSweepert{ 
int eliteSweep(); 
} 


我 们 还 需要 确保 eliteSsweep() 方 法 会 被 声明 在 spitterRepository 接 
口中 。 要 实现 这 一 点 ， 避 免 代 码 重 复 的 简单 方式 就 是 修 
改 SpitterRepository， 让 它 扩展 SpitterSweeper: 


public interface SpitterRepository 
extends JpaRepository<Spitter, Long>, 


SpitterSweeper { 








如 前 所 述 ，Spring Data JPA 将 实现 类 与 接口 天 联 起 来 是 基于 接口 的 名 
称 。 但 是 ，Imp1 后 级 只 是 默认 的 做 法 ， 如 果 你 想 使 用 其 他 后 级 的 话 ， 只 
需 在 配置 @QEnableJpa-Repositories 的 时 候 ， 设 

置 repositoryImplementationPostfix 属 性 即 可 : 


@EnableJpaRepositories( 


basePackages="com.habuma.spittr.db", 
repositoryImplementationpostfix="Helper") 





如 果 在 XML 中 使 用 <jpa:repositories> 元 素来 配置 Spring Data JPA 的 
话 ， 我 们 可 以 借助 repository-impl-postfix 属 性 指定 后 级 : 


<jpa:repositories base-package="com.habuma.spittr.db" 


repository-impl-postfix="Helper" /> 





我 们 将 后 级 设置 成 了 Helper，Spring Data JPA 将 会 查找 名 
为 SpitterRepository-Helper 的 类 ， 用 它 来 匹 
配 SpitterRepository 接 口 。 


11 4 汉 S 


对 于 很 多 应 用 来 讲 ， 关 系 型 数据 库 是 主流 的 数据 存储 形式 ， 并 且 这 种 情 
况 已 经 持续 了 很 多 年 。 使 用 JDBC 并 且 将 对 象 映射 为 数据 库 表 是 很 烦琐 
乏味 的 事情 ， 像 Hibernate 和 JPA 这 样 的 ORM 方 案 能 够 让 我 们 以 更 加 声明 
式 的 模型 实现 数据 持久 化 。 尽 管 Spring 没有 为 ORM 提 供 直 接 的 支持 ， 但 
是 它 能 够 与 多 种 流行 的 ORM 方 案 集 成 ， 包 括 Hibernate 与 Java 持 久 化 
API。 


在 本 章 中 ， 我 们 看 到 了 如 何在 Spring 应 用 中 使 用 Hibernate 的 上 下 文 
Session， 这 样 我 们 的 Repository 束 能 包含 很 少 甚 至 不 包含 Spring 相关 的 代 
码 。 与 之 类 似 ， 我 们 还 看 到 了 如 何 将 EntityManagerFactory 

或 EntityManager 注 入 到 Repository 实 现 中 ， 从 而 实现 不 依赖 于 Spring 的 
JPA Repository。 


我 们 稍 后 初步 了 解 了 Spring Data， 在 这 个 过 程 中 ， 只 需 声 明 JPA 
Repository 接 口 即 可 ， 让 Spring Data JPA 在 运行 时 自动 生成 这 些 接口 的 实 
现 。 当 我 们 需要 的 Repository 方 法 超出 了 Spring Data JPA 所 提供 的 功能 
时 ， 可 以 借助 QQuery 注 解 以 及 编写 自 定 义 的 Repository 方 法 来 实现 。 


但 是 ， 对 于 Spring Data 的 整体 功能 来 说 ， 我 们 只 是 接触 到 了 皮 毛 。 在 下 
一 章 中 ， 我 们 将 会 更 加 深入 地 学 习 Spring Data 的 方法 命名 DSL， 以 及 
Spring Data 如 何 为 天 系 型 数据 库 以 外 的 领域 带 来 帮助 。 也 就 是 说 ; 我 们 
将 会 看 到 Spring Data 如 何 支 持 新 兴 的 NoSQL 数 据 库 ， 这 些 数据 库 在 最 近 
几 年 变 得 越 来 越 流 行 。 











第 12 音 ”使 用 NoSQL 数 据 库 


本 章 内 容 : 


。 为 MongoDB 和 Neo4j 编 写 Repository 
。 为 多 种 数据 存储 形式 持久 化 数据 
。 组 合 使 用 Spring 和 Redis 


享 利 ' 福 特 在 他 的 目 传 中 曾经 写 过 一 句 很 闭 名 的 话 :“ 任 何 顾客 可 以 将 这 
辆 车 漆 成 任何 他 所 愿意 的 颜色 ， 只 要 保持 它 的 黑色 就 可 以 "L111。 有 人 说 
这 人 句 话 是 傲慢 和 固执 的 ， 而 有 些 人 则 说 这 句 话 反映 出 了 他 的 幽默 。 事 实 
上 ， 在 这 本 自传 出 版 的 时 候 ， 他 通过 使 用 一 种 快速 烘 干 的 油漆 降低 了 成 
本 ， 而 当时 这 种 油漆 只 有 黑色 的 。 


福特 的 这 名 著名 的 话 也 可 以 用 在 数据 库 领 域 ， 多 年 来 ， 我 们 一 直 和 被 告 
知 ， 我 们 可 以 使 用 任意 想 要 的 数据 库 ， 只 要 它 是 关系 型 数据 库 就 行 。 关 
系 型 数据 库 已 经 垄断 应 用 开 友 领域 好 多 年 了 。 


随 看 一些 苋 争 者 进入 数据 库 领 域 ， 关系 型 数据 库 的 垄断 地 位 开始 被 弱 
化 。 所 谓 的 “NoSQL” 数 据 库 开始 侵入 生产 型 的 应 用 之 中 ， 我 们 也 认识 到 
并 没有 一 种 全 能 型 的 数据 库 。 现 在 有 了 更 多 的 可 选 方 案 ， 所 以 能 够 为 要 
解决 的 问题 选择 最 佳 的 数据 库 。 


在 前 面 的 几 章 中 ， 我 们 关注 于 关系 型 数据 库 ， 首 先 使 用 Spring 对 JDBC 文 
持 ， 然 后 使 用 对 象 - 关 系 映 射 。 在 上 一 章 ， 我 们 看 到 了 Spring Data JPA， 
它 是 Spring Data 项 目下 的 多 个 子 项 目 之 一 。 通 过 在 运行 时 目 动 生成 
Repository 实 现 ，Spring Data JPA 能 够 让 使 用 JPA 的 过 程 更 加 简单 容易 。 


Spring Data 还 提供 了 对 多 种 NoSQL 数 据 库 的 支持 ， 包 括 MongoDB、 
Neo4j 和 Redis。 它 不 仪 支持 目 动 化 的 Repository， 还 支持 基于 模板 的 数据 
访问 和 映射 注解 。 在 本 章 中 ， 将 会 看 到 如 何 为 非 关系 型 的 NoSQL 数 据 库 
编写 Repository。 首 先 ， 我 们 将 从 Spring Data MongoDB 开 始 ， 看 一 下 如 
何 编写 Repository 来 处 理 基 于 文档 的 数据 。 














12.1 使 用 MongoDB 持 久 化 文档 数据 


有 一 些 数 据 的 最 佳 表现 形式 是 文档 (document) 。 也 就 是 说 ， 不 要 把 这 
些 数据 分 散 到 多 个 表 、 节 点 或 实体 中 ， 将 这 些 信 息 收 集 到 一 个 非 规范 化 
(也 就 是 文档 〉 的 结构 中 会 更 有 意义 。 尺 管 两 个 或 两 个 以 上 的 文档 有 可 
能 会 彼此 产生 关联 ， 但 是 通常 来 讲 ， 文 档 是 独立 的 实体 。 能 够 按照 这 种 
方式 优化 并 处 理 文档 的 数据 库 ， 我 们 称 之 为 文档 数据 库 。 


例如 ， 假 设 我 们 要 编写 一 个 应 用 程序 来 获取 大 学 生 的 成 绩 单 ， 可 能 需要 
根据 学 生 的 名 字 来 查询 其 成 绩 单 ， 或 者 根据 一 些 通用 的 属性 来 得 询 成 绩 
单 。 但 是 ， 每 个 学 生 是 相互 独立 的 ， 任 意 的 两 个 成 绩 单 之 间 没 有 必要 相 
互 天 联 。 尺 管 我 们 能 够 使 用 关系 型 数据 库 模 式 来 获取 成 绩 单 数据 (也许 
你 曾经 这 样 做 过 ) ， 但 文档 型 数据 库 可 能 才 是 更 好 的 方案 。 


文档 数据 库 不 适用 于 什么 场景 


了 解 文档 型 数据 库 能 够 用 于 什么 场景 是 很 重要 的 。 但 是 ， 知 道 文 档 型 数 
据 库 在 什么 情况 下 不 适用 同样 也 是 很 重要 的 。 文 档 数 据 库 不 是 通用 的 数 
据 库 ， 它 们 所 擅长 解决 的 是 一 个 很 小 的 问题 集 。 


有 些 数据 具有 明显 的 关联 关系 ， 文 档 型 数据 库 并 没有 针对 存储 这 样 的 数 
据 进 行 优 化 。 例 如 ， 社 交 网 络 表现 了 应 用 中 不 同 的 用 户 之 间 是 如 何 建立 
关联 的 ， 这 种 情况 就 不 适合 放 到 文档 型 数据 库 中 。 在 文档 数据 库 中 存储 
具有 丰富 关联 关系 的 数据 也 并 非 完 全 不 可 能 ， 但 这 样 做 的 话 ， 你 通常 会 
发 现 遇 到 的 挑战 要 多 于 所 带 来 的 收益 。 


Spittr 应 用 的 域 对 象 并 不 适合 文档 数据 库 。 在 本 章 中 ， 我 们 将 会 在 一 个 
购物 订单 系统 中 学 习 MongoDB。 


MongoDB 是 最 为 流行 的 开源 文档 数据 库 之 一 。Spring Data MongoDB 提 
供 了 三 种 方式 在 Spring 应 用 中 使 用 MongoDB: 

。 通 过 注解 实现 对 象 -文档 映射 

。 使 用 MongoTemplate 实 现 基于 模板 的 数据 库 访 问 ; 

。 自动 化 的 运行 时 Repository 生 成 功能 。 


我 们 已 经 看 到 Spring Data JPA 如 何 为 基于 JPA 的 数据 访问 实现 上 自动 化 


















































Repository 生 成 功能 。Spring Data MongoDB 为 基于 MongoDB 的 数据 访问 
提供 了 相同 的 功能 。 


不 过 ， 与 Spring Data JPA 不 同 的 是 ，Spring Data MongoDB 提 供 了 将 Java 
对 象 映射 为 文档 的 功能 。 (Spring Data JPA 没 有 必要 为 JPA 提 供 这 样 的 
注解 ， 因 为 JPA 规 范本 喘 就 提供 了 对 象 -关系 映射 注解 ) 。 除 此 之 外 ， 
人 Data MongoDB 为 通用 的 文档 操作 任务 提供 了 基于 模板 的 数据 访 
问 方式 。 


但 是 ， 在 使 用 这 些 特性 之 前 ， 我 们 首先 要 配置 Spring Data MongoDB。 
12.1.1 启用 MongoDB 


为 了 有 效 地 使 用 Spring Data MongoDB， 我 们 需要 在 Spring 配置 中 添加 几 
个 必要 的 bean。 首 先 ， 我 们 需要 配置 MongoClient， 以 便于 访问 
MongoDB 数 据 库 。 同 时 ， 我 们 还 需要 有 一 个 MongoTemplate bean， 实 
现 基于 模板 的 数据 库 访问 。 此 外 ， 不 是 必须 ， 但 是 强烈 推荐 启用 Spring 
Data MongoDB 的 自动 化 Repository 生 成 功能 。 


如 下 的 程序 清单 展现 了 如 何 编写 简单 的 Spring Data MongoDB 配 置 类 ， 
它 包 含 了 上 述 的 几 个 bean: 


程序 清单 12.1 Spring Data MongoDB 的 必要 配置 





EnableMongoRepositories; 
import com.mongodb.Mongo; 
@Configuration 启用 MongoDB 
@EnableMongoRepositories(basePackages="orders .db") < 的 Repository 功 能 





MongoClient bean 
ew MongoFactoryBean(}); 





GBean 
public MongoOperations mongoTemplate(Mongo mongo) { ~ MongoTemplate bean 
return new MongoTemplate (mongo, "OrdersDB"); 


在 上 一 章 中 ， 我 们 通过 @EnableJpaRepositories 注 解 ， 启 用 了 Spring 
Data 的 自动 化 JPA Repository 生 成 功能 。 与 之 类 
似 ，@EnableMongoRepositories 为 MongoDB 实 现 了 相同 的 功能 。 


除了 @EnableMongoRepositories 之 外 ， 程 序 清单 12.1 中 还 包含 了 两 个 
带 有 @Bean 注 解 的 方法 。 第 一 个 @Bean 方 法 使 用 MongoFactoryBean 声 
明了 一 个 Mongo 实 例 。 这 个 bean 将 Spring Data MongoDB 与 数据 库 本 号 连 
接 了 起 来 (与 使 用 关系 型 数据 时 DataSource 所 做 的 事情 并 没有 什么 区 
别 ) 。 尽 管 我 们 可 以 使 用 MongoClient 直 接 创建 Mongo 实 例 ， 但 如 果 这 
样 做 的 话 ， 就 必须 要 处 理 MongoClient 构 造 器 所 抛 出 的 
UnknownHostException 异 常 。 在 这 里 ， 使 用 Spring Data MongoDB 的 
MongoFactoryBean 更 加 简单 。 因 为 它 是 一 个 工厂 bean， 

此 MongoFactoryBean 会 负责 构建 Mongo 实 例 ， 我 们 不 必 再 担心 
UnknownHostException 异 常 。 








另外 一 个 @Bean 方 法 声明 了 MongoTemplate bean， 在 它 构 造 时 ， 使 用 
了 其 他 @Bean 方 法 所 创建 的 Mongo 实 例 的 引用 以 及 数据 库 的 名 称 。 稍 
后 ， 你 将 会 看 到 如 何 使 用 MongoTemplate 来 查询 数据 库 。 即 便 不 直接 使 
用 MongoTemplate， 我 们 也 会 需要 这 个 bean， 因 为 Repository 的 自动 化 
生成 功能 在 底层 使 用 了 它 。 


除了 直接 声明 这 些 bean， 我 们 还 可 以 让 配置 类 扩展 AbstractMongo- 


Configuration 并 重 载 getDatabaseName() 和 mongo() 方 法 。 如 下 的 
程序 清单 展现 了 如 何 使 用 这 种 配置 方式 。 


程序 清单 12.2 借助 @EnableMongoRepositories 启 用 Spring Data 
MongoDB 


package orders.config; 
import org.springframework.context .annotation.Configuration; 
import org.springframework.data.mongodb.config. 


Abstr 





import org.springframework.data.mongodb.reposito 
import com.mongodb.Mongo; 
import com.mongodb.MongoClient; 


@Configuration 


@EnableMongoRepositories!{l"orders.db") 


ic class MongoConfig extends AbstractMongoConfiguration { 
aOve 3 
rotecte erin cernatabhaceName[l) { se 来 1 上 3 Ay Flr 
protected String getDatabaseName() { - 指定 数据 库 名 称 
return "OrdersDB",; 
@Overrid 
public Mongo mongo () throws Exception { L 创建 Mongo 客户 端 
return new Mongoclient() 


这 个 新 的 配置 类 与 程序 清单 12.1 的 功能 是 相同 的 ， 只 不 过 在 篇 幅 上 更 加 
简洁 。 最 为 显 车 的 区 别 在 于 这 个 配置 中 没有 直接 声明 MongoTemplate 
bean， 当 然 它 还 是 会 被 隐 式 地 创建 。 我 们 在 这 里 重 载 了 
getDatabaseName( ) 方 法 来 提供 数据 库 的 名 称 。mongo( ) 方 法 依然 会 创 
吝 一 个 MongoClient 的 实例 ， 因 为 它 会 殷 出 Exception， 所 以 我 们 可 以 
直接 使 用 MongoClient， 而 不 必 再 使 用 MongoFactoryBean 了 了 。 


到 目前 为 上 ， 不 管 是 使 用 程序 清单 12.1 还 是 12.2， 都 为 Spring Data 
MongoDB 提 供 了 一 个 运行 配置 ， 也 就 是 说 ， 只 要 MongoDB 服 务 器 运行 
在 本 地 即 可 。 如 果 MongoDB 服 务 器 运行 在 其 他 的 机 器 上 ， 那 么 可 以 在 
创建 MongoClient 的 时 候 进 行 指定 : 


public Mongo mongo() throws Exception { 
return new MongoClient("mongodbserver"); 


} 


另外 ，MongoDB 服 务 器 有 可 能 监听 的 端口 并 不 是 默认 的 27017。 如 果 是 
这 样 的 话 ， 在 创建 MongoClient 的 时 候 ， 还 需要 指定 端口 : 


public Mongo mongo() throws Exception { 
return new MongoClient("mongodbserver", 37017); 


} 


如 果 MongoDB 服 务 右 运行 在 生产 配置 上 ， 我 认为 你 可 能 还 启用 了 认证 
功能 。 在 这 种 情况 下 ， 为 了 访问 数据 库 ， 我 们 还 需要 提供 应 用 的 凭证 。 
访问 需要 认证 的 MongoDB 服 务 器 稍微 有 些 复杂 ， 如 下 面 的 程序 清单 所 
和 修 。 





程序 清单 12.3 创建 MongoClient 来 访问 需要 认证 的 MongoDB 服 务 器 





redential = 
创建 MongoDB 和 凭证 
env .getProperty("mongo.username"), 


oOo.password") .toCcharArray ()); 


创建 MongoClient 





为 了 访问 需要 认证 的 MongoDB 服 务 器 ，MongoClient 在 实例 化 的 时 候 

必须 要 有 一 个 MongoCredential 的 列表 。 在 程序 清单 12.3 中 ， 我 们 为 此 
创建 了 一 个 MongoCredential。 为 了 将 和 凭证 信息 的 细节 放 在 配置 类 外 

边 ， 它 们 是 通过 注入 的 Environment 对 象 解析 得 到 的 。 


为 了 使 这 个 讨论 更 加 完整 ，Spring Data MongoDB 还 文 持 通过 XML 来 进 

行 配置 。 你 可 能 也 知道 ， 我 更 喜欢 Java 配 置 的 方案 。 但 是 ， 如 果 你 喜欢 
XML 配置 的 话 ， 如 下 的 程序 清单 展现 了 如 何 使 用 mongo 配 置 命名 空间 来 
配置 Spring Data MongoDB。 


程序 清单 12.4 Spring Data MongoDB 提 供 了 XML 配置 的 方案 


声明 mongo 


命名 空间 





http://www.Sspringframework.org/schema/beans 
声明 Se 和 
http://Ww 
Mongo Client 
A eT ey Fre et 启用 Repository 
<mMONngO: repositories Dase~-packrkage="orders.dp" /> 已 eposlitory 


生成 功能 


ht I 了 
http://www.springframework.org/schema/data/mongo/spring-mongo.xsd 
了 
了 


g/schema/beans/spring-beans .xsd"> 





<mongo:mongo /> 创 建 
< id="mongoTemplate" MongoTemplate bean 


rg.springframework.data.mongodb.core.MongoTemplate"> 





现在 Spring Data MongoDB 已 经 配置 完成 了 ， 我 们 很 快 就 可 以 使 用 它 来 
保存 和 查询 文档 了 。 但 首先 ， 需 要 使 用 Spring Data MongoDB 的 对 象 - 文 
档 映 射 注 解 为 Java 领 域 对 象 建立 到 持久 化 文档 的 映射 关系 。 


12.1.2 ”为 模型 添加 注解 ， 实 现 MongoDB 持 久 化 


当 使 用 JPA 的 时 候 ， 我 们 需要 将 Java 实 体 类 映射 到 关系 型 表 和 列 上 。JPA 
规范 提供 了 一 些 文 持 对 象 - 关 系 映 射 的 注解 ， 而 有 一 些 JPA 实 现 ， 如 
Hibernate， 也 添加 了 自己 的 映射 注解 。 


但 是 ， MongoDB 并 没有 提供 对 象 -文档 映射 的 注解 。Spring Data 
MongoDB 填 补 了 这 一 空白 ， 提 供 了 一 些 将 Java 类 型 映射 为 MongoDB 文 
档 的 注解 。 表 12.1 描 述 了 这 些 注解 。 


表 12.1 用 于 对 象 -文档 映射 的 Spring Data MongoDB 注 解 
































描 


标示 映射 到 MongoDB 文 档 上 的 领域 对 象 


i 


标示 某 个 域 要 引用 其 他 的 文档 ， 这 个 文档 有 可 能 位 于 另外 一 个 数据 库 中 





@Field | 为 文档 域 指定 自 定义 的 元 数据 


标示 某 个 属性 用 作 瞩 本 域 








@Document 和 @Id 注 解 类 似 于 JPA 的 @Entity 和 @Id 注 解 。 我 们 将 会 经 常 
使 用 这 两 个 注解 ， 对 于 要 以 文档 形式 保存 到 MongoDB 数 据 库 的 每 个 Java 
类 型 都 会 使 用 这 两 个 注解 。 例 如 ， 如 下 的 程序 清单 展现 了 如 何 为 Order 
类 添加 注解 ， 它 会 被 持久 化 到 MongoDB 中 。 


程序 清单 12.5 ”Spring Data MongoDB 注 解 将 Java 类 型 映射 为 文档 


package orders; 

import java.util.Collection; 

import java.util.LinkedHashSset; 

import org.springframework.data.annotation.Id; 

import org.springframework.data.mongodb.core.mapping.Document; 


import org.springframework.data.mongodb.core.mapping .Field; 


@Document a 这 是 -个 文档 


public class Order { 


GIG 

private String id; < 一 指定 ID 
GField("client") 

private String customer; 4 覆盖 默认 的 域名 


private String type:; 


private Collection<Item> items = new LinkedHashSet<Item>{(); 
public String getCustomer() { 


return customer; 


public void setCustomer (String customer) {1 
this.customer = customer; 


public String getType() { 


return type; 





public void setTypel(String type) { 
this.type = type; 

public Collection<Item> getIitems() { 
return items; 

} 

Public void setItems{Collection<Item> items) { 
this.items = items; 

} 

public String getIid() { 
return id; 

} 

} 


我 们 可 以 看 到 ，Order 类 添加 了 @Document 注 解 ， 这 样 它 就 能 够 借助 
MongoTemplate 或 自动 生成 的 Repository 进 行 持 久 化 。 其 id 属 性 上 使 用 
了 Q@Id 注 解 ， 用 来 指定 它 作为 文档 的 ID。 除 此 之 外 ，customer 属 性 上 使 
用 了 @Fie1d 注 解 ， 这 样 的 话 ， 当 文档 持久 化 的 时 候 customer 属 性 将 会 
映射 为 名 为 client 的 域 。 


注意 ， 其 他 的 属性 并 没有 添加 注解 。 除 非 将 属性 设置 为 瞬时 态 

Ctransient) 的 ， 人 否则 Java 对 象 中 所 有 的 域 都 会 持久 化 为 文档 中 的 域 。 
并 且 如 果 我 们 不 使 用 @Fie1d 注 解 进 行 设置 的 话 ， 那 么 文档 域 中 的 名 字 
将 会 与 对 应 的 Java 属 性 相同 。 





同时 ， 需 要 注意 的 是 items 属 性 ， 它 指 的 是 订单 中 具体 条 目的 集合 。 

传统 的 关系 型 数据 库 中 ， 这 些 条 目 将 会 保存 在 另外 的 一 个 数据 库 表 中 ， 
通过 外 键 进 行 应 用 ，items 域 上 很 可 能 还 会 使 用 JPA 的 @oneToMany 注 
解 。 但 在 这 里 ， 情 形 完全 不 同 。 





id 
customer 
type 


id 
order 
product 
price 
quantity 




















图 12.1 文档 展现 了 关联 但 非 规范 化 的 数据 。 
相关 的 概念 〈 如 订单 中 的 条 目 ) 被 嵌入 到 顶层 的 文档 数据 中 


如 我 前 面 所 述 ， 文 档 可 以 与 其 他 的 文档 产生 关联 ， 
库 所 擅长 的 功能 。 在 本 例 购 买 订 单 与 行 条 目 之 间 的 关联 关系 中 ， 行 条 目 
只 是 同一 个 订单 文档 里 面 内 髓 的 一 部 分 (如 图 12.1 所 示 》。 因此 没有 
这 种 关联 关系 添加 任何 注解 。 实 际 上 ，Item 类 本 身 并 没有 任何 注 
在 : 














package orders; 


public class Item { 


private Long id; 
private Order order; 
private String product; 
private double price; 
private int quantity; 


public Order getorder() { 
return order; 


} 


public String getProduct() { 
return product; 


} 


public void setProduct(String product) { 
this.product = product; 


public double getPrice() { 
return price; 


} 


public void setPrice(double price) { 
this.price = price; 


public int getQuantity() { 
return quantity; 


} 


public void setQuantity(int quantity) { 
this.quantity = quantity; 


public Long getId() { 
return id; 
} 
} 





我 们 没有 必要 为 Ttem 添 加 @Document 注 解 ， 也 没有 必要 为 它 的 域 指定 
@Id。 这 是 因为 我 们 不 会 单独 将 Item 持 久 化 为 文档 。 它 始终 会 是 Order 
文档 中 Item 列 表 的 一 个 成 员 ， 并 且 会 作为 文档 中 的 租 入 元 素 。 

当然 ， 如 果 你 想 指定 Item 中 的 某 个 域 如 何 持久 化 到 文档 中 ， 那 么 可 以 为 
对 应 的 Item 属 性 添加 @Field 注 解 。 不 过 在 本 例 中 ， 并 没有 必要 这 样 
做 。 


我 们 现在 已 经 为 Java 对 象 添加 了 MongoDB 持 久 化 的 注解 。 接 下 来 ， 看 一 
下 如 何 使 用 MongoTemplate 来 存储 它们 。 


12.1.3 ”使 用 MongoTemplate 访 问 MongoDB 





我 们 已 经 在 配置 类 中 配置 了 MongoTemplate bean， 不 管 是 显 式 声明 还 
是 扩展 AbstractMongoConfiguration 都 能 实现 相同 的 效果 。 接 下 
来 ， 需 要 做 的 就 是 将 其 注入 到 使 用 它 的 地 方 : 


@Autowired 
MongoOperations mongo; 


注意 ， 在 这 里 我 们 将 MongoTemplate 注 入 到 一 个 类 型 

为 Mongo0perations 的 属性 中 。MongoOperations 是 MongoTemplate 
所 实现 的 接口 ， 不 使 用 具体 实现 是 一 个 好 的 做 法 ， 尤 其 是 在 注入 的 时 
候 。 


MongoOperations 芭 露 了 多 个 使 用 MongoDB 文 档 数 据 库 的 方法 。 在 这 
里 ， 我 们 不 可 能 讨论 所 有 的 方法 ， 但 是 可 以 看 一 下 最 为 常用 的 几 个 操 
作 ， 比 如 计算 文档 集合 中 有 多 少 条 文档 。 使 用 注入 的 
MongoOperations， 我 们 可 以 得 到 Order 和 集合 并 调用 count() 来 得 到 数 
里 : 


long orderCount = mongo.getCollection("order") .count() 


现在 ， 假 设 要 保存 一 个 新 的 Order。 为 了 完成 这 个 任务 ， 我 们 可 以 调 
用 save() 方 法 : 








Order order = new Order(); 
... // set properties and add line items 


mongo.save(order, "order"); 





save() 方 法 的 第 一 个 参数 是 新 创建 的 0rder， 第 二 个 参数 是 要 保存 的 文档 
存储 的 名 称 。 


另外 ， 我 们 还 可 以 调用 findById() 方 法 来 根据 ID 查 找 订单 : 


String orderId = ...; 





Order order = mongo.findById(orderId, Order.class); 


对 于 更 高 级 的 查询 ， 我 们 需要 构造 Query 对 象 并 将 其 传递 给 find() 方 
法 。 例 如 ， 要 查找 所 有 client 域 等 于 “Chuck Wagon” 的 订单 ， 可 以 使 用 
如 下 的 代码 : 


List<Order> chucksOrders = mongo.find(Query .query( 





Criteria.where("client").is("Chuck Wagon")), Order.class); 


在 本 例 中 ， 用 来 构造 Query 对 象 的 Criteria 只 检查 了 一 个 域 ， 但 是 它 也 可 
以 用 来 构造 更 加 有 意思 的 查询 。 比 如 ， 我 们 想 要 查询 Chuck 所 有 通过 
Web 创 建 的 订单 : 


List<Order> chucksWebOrders = mongo.find(Query .query( 


Criteria.where("customer").is("Chuck Wagon") 
.and("type").is("WEB")), Order.class); 





如 琳 你 想 移 除 某 一 个 文档 的 话 ， 那 么 束 应 该 使 用 remove( ) 方 法 : 


mongo.remove(order); 


如 我 前 面 所 述 ，MongoOperations 有 多 个 操作 文档 数据 的 方法 。 我 建 
议 你 查看 一 下 其 JavaDoc 文 档 ， 以 了 解 通过 Mongo0perations 都 能 完成 
什么 功能 。 


通常 来 讲 ， 我 们 会 将 Mongo0perations 注 入 到 自己 设计 的 Repository 类 
中 ， 并 使 用 它 的 操作 来 实现 Repository 方 法 。 但 是 ， 如 果 你 不 愿意 编写 
Repository 的 话 ， 那 么 Spring Data MongoDB 能 够 自动 在 运行 时 生成 
Repository 实 现 。 下 面 ， 我 们 来 看 一 下 是 如 何 实现 的 。 





12.1.4 编写 MongoDB Repository 


为 了 理解 如 何 使 用 Spring Data MongoDB 来 创建 Repository， 让 我 们 先 回 
忆 一 下 在 第 11 章 中 是 如 何 使 用 Spring Data JPA 的 。 在 程序 清单 11.4 中 ， 
我 们 创建 了 一 个 扩展 自 ]paRepository 的 SpitterRepository 接 口 。 
在 那 一 小 节 中 ， 我 们 还 启用 了 Spring Data JPA Repository 功 能 。 这 样 
的 结果 就 是 Spring Data JPA 能 够 自动 创建 接口 的 实现 ， 其 中 包括 了 多 个 
内 置 的 方法 以 及 我 们 所 添加 的 遵循 命名 约定 的 方法 。 


我 们 已 经 通过 @EnableMongoRepositories 注 解 启 用 了 Spring Data 
MongoDB 的 Repository 功 能 ， 接 下 来 需要 做 的 就 是 创建 一 个 接口 ， 
Repository 实 现 要 基于 这 个 接口 来 生成 。 不 过 ， 在 这 里 ， 我 们 不 再 扩 - 
展 JpaRepository， 而 是 要 扩展 MongoRepository。 如 下 程序 清单 中 
的 OrderRepository 扩 展 了 MongoRepository， 为 Order 文 档 提 供 了 
基本 的 CRUD 操 作 。 


程序 清单 12.6 ”Spring Data MongoDB 会 目 动 实现 Repository 接 口 


package orders .db 
import orders.Order; 
import org.springframework.data.mongodb .repository.MongoRepository ; 


public interface OrderRepository 
extends MongoRepository<Order, String> { 





} 


因为 OorderRepository 扩 展 了 MongoRepository， 因 此 它 就 会 传递 性 
地 扩展 Repository 标 记 接 口 。 回 忆 一 下 我 们 在 学 习 Spring Data JPA 时 所 了 
解 的 知识 ， 任 何 扩展 Repository 的 接口 将 会 在 运行 时 自动 生成 实现 。 
在 本 例 中 ， 并 不 会 实现 与 关系 型 数据 库 交 互 的 JPA Repository， 而 是 会 
为 0rderRepository 生 成 读 取 和 写 入 数据 到 MongoDB 文 档 数据 库 的 实 
现 。 





MongoRepository 接 口 有 两 个 参数 ， 第 一 个 是 带 有 @Document 注 解 的 对 
象 类 型 ， 也 就 是 该 Repository 要 处 理 的 类 型 。 第 二 个 参数 是 种 有 @Id 注 解 
的 属性 类 型 。 


尽管 0rderRepository 本 喘 并 没有 定义 任何 方法 ， 但 是 它 会 继承 多 个 
方法 ， 包 括 对 Order 文 档 进行 CRUD 操 作 的 方法 。 表 12.2 描 述 了 
OrderRepository 继 承 的 所 有 方法 。 








表 12.2 通过 扩展 MongoRepository，Repository 接 口 能 够 继承 多 个 CRUD 操 作 ， 它 们 会 由 
Spring Data MongoDB 自 动 实现 
































void deleteAl1(); 删除 指定 Repository 类 型 的 所 有 文档 


如 果 存 在 与 指定 对 象 相关 联 的 文档 ， 则 返回 


true 


boolean exists(Object); 





























类 刑 ， 1 
List<T> findAll(Pageable); i 返 





代 


为 指定 的 Repository 类 型 ， 返 回 排序 后 的 所 
有 文档 列表 


<S extends T> 由 <S> save 


表 12.2 中 的 方法 使 用 了 传递 进来 和 方法 返回 的 泛 型 。0rderRepository 
扩展 了 MongoRepository<Order，String>， 那么 T 就 映射 
为 Order，ID 映 财 为 String， 而 Ss 映射 为 所 有 扩展 Oorder 的 类 型 。 


添加 自 定 义 的 查询 方法 


通常 来 讲 ，CRUD 操 作 是 很 有 用 的 ， 但 我 们 有 时 候 可 能 希望 Repository 提 
供 除 内 置 方法 以 外 的 其 他 方法 。 


在 11.3.1 小 市 中 ， 我 们 学 习 了 Spring Data JPA 文 持 方 法 命名 约定 ， 它 能 
够 帮助 Spring Data 为 遵循 约定 的 方法 自动 生成 实现 。 实 际 上 ， 相 同 的 约 








List<T> findAll(Sort); 

















定 也 适用 于 Spring Data MongoDB。 这 意味 着 我 们 可 以 
为 OrderRepository 添 加 自 定义 的 方法 : 


public interface OrderRepository 
extends MongoRepository<Order, String> { 
List<Order> findByCustomer(String c); 


List<Order> findByCustomerLike(String c); 
List<Order> findByCustomerAndType(String c, String t); 
List<Order> findByCustomerLikeAndType(String c, String t); 





这 里 我 们 有 四 个 新 的 方法 ， 每 一 个 都 是 查找 满足 特定 条 件 的 Order 对 
象 。 其 中 第 一 个 用 来 获取 customer 属 性 等 于 传 入 值 的 Order 列 表 ; 第 二 
个 方法 获取 customer 属 性 like 传 入 值 的 0rder 列 表 ; 接 下 来 方法 会 返回 
customer 和 type 属 性 等 于 传 入 值 的 Order 对 象 ， 最 后 一 个 方法 与 前 一 
个 类 似 ， 只 不 过 customer 在 对 比 的 时 候 使 用 的 是 like 而 不 是 equals。 


其 中 ，find 这 个 查询 动词 并 不 是 固定 的 。 如 果 喜 欢 的 话 ， 我 们 还 可 以 使 
用 get 作 为 查询 动词 : 





List<Order> getByCustomer(String c); 


如 果 read 更 适合 的 话 ， 你 还 可 以 使 用 这 个 动词 : 


List<Order> readByCustomer(String c); 
除 此 之 外 ， 还 有 一 个 特殊 的 动词 用 来 为 匹配 的 对 象 计数 : 


int countByCustomer(String c); 


与 Spring Data JPA 类 似 ， 在 查询 动 词 与 By 之 前 ， 我 们 有 很 大 的 灵活 性 。 
例如 ， 我 们 可 以 标示 要 得 找 什么 内 容 : 


List<Order> findordersByCustomer(String c); 


其 中 ，Orders 这 个 词 没 并 没有 什么 特殊 之 处 ， 它 不 会 影响 要 获取 的 内 
容 。 我 们 也 可 以 将 方法 按照 如 下 的 方式 命名 : 


List<Order> findSomeStuffWeNeedByCustomer(String c); 





其 实 ， 并 不 是 必须 要 返回 List<Order>， 如 果 只 想 要 一 个 Order 对 象 的 
话 ， 我 们 可 以 只 需 简 单 地 返回 Order: 


Order findASingleOrderByCustomer(String c) 


这 里 ， 所 返回 的 就 是 原本 List 中 的 第 一 个 Order 对 象 。 如 宁 没 有 匹配 元 
素 的 话 ， 方 法 将 会 返回 null。 


旨 定 查询 


在 11.3.2 小 节 中 ，@Query 注 解 可 以 为 Repository 方 法 指定 自 定 义 的 得 
询 。@Query 能 够 像 在 JPA 中 那样 用 在 MongoDB 上 。 唯 一 的 区 别 在 于 针 
对 MongoDB 时 ，@Query 会 接受 一 个 JSON 碍 询 ， 而 不 是 JPA 碍 询 。 


例如 ， 假 设 我 们 想 要 查询 给 定 类 型 的 订单 ， 并 且 要 求 customer 的 名 称 
为 “Chuck Wagon”。OrderRepository 中 如 下 的 方法 声明 能 够 完成 所 需 
的 任务 : 





@Query("{'customer': “Chuck Wagon', 'type' : ?0}") 


List<Order> findChucksOrders(String t); 





QQuery 中 给 定 的 JSON 将 会 与 所 有 的 Order 文 档 进 行 匹配 ， 并 返回 匹配 
的 文档 。 需 要 注意 的 是 ，type 属 性 映射 成 了 “?6”， 这 表明 type 属 性 应 
该 与 查询 方法 的 第 零 个 参数 相等 。 如 果 有 多 个 参数 的 话 ， 它 们 可 以 通 
过 “?1”、“?2” 等 方式 进行 引用 。 


混合 上 自 定 义 的 功能 


在 11.3.3 小 节 中 ， 我 们 学 习 了 如 何 将 完全 自 定义 的 方法 混合 到 目 动 生成 
的 Repository 中 。 对 于 JPA 来 说 ， 这 还 涉及 到 创建 一 个 中 间接 口 来 声明 自 
定义 的 方法 ， 为 这 些 自 定 义 方 法 创建 实现 类 并 修改 自动 化 的 Repository 
接口 ， 使 其 扩展 中 间接 口 。 对 于 Spring Data MongoDB 来 说 ， 这 些 步骤 
都 是 相同 的 。 


假设 我 们 想 要 查询 文档 中 type 属 性 匹配 给 定 值 的 Order 对 象 。 我 们 可 以 
通过 创建 签名 为 List<order> findByType(String t) 的 方法 ， 很 容 
易 实 现 这 个 功能 。 但 是 ， 如 果 给 定 的 类 型 是 “NET”， 那 我 们 就 查找 type 























值 为 “WEB” 的 Order 对 象 。 要 实现 这 个 功能 的 话 ， 这 就 有 些 困 难 了 ， 即 
便 使 用 QQuery 注 解 也 不 容易 实现 。 不 过 ， 混 合 实现 的 做 法 能 够 完成 这 
项 任务 。 


首先 ， 定 义 中 间接 口 : 





package orders.db; 
import java.util.List; 
import orders.Order; 


public interface OrderOperations { 
List<Order> findordersByType(String t); 


} 








这 非常 简单 。 接 下 来 ， 我 们 要 编写 混合 实现 ， 具 体 实 现 如 下 面 的 程序 清 
单 所 示 。 


程序 清单 12.7 将 自 定 义 的 Repository 功 能 注入 到 目 动 生成 的 
Repository 中 





Public class OrderRepositoryIimp!l 
@Autowired 
private MongoOperations mongo; 本 注入 MongoOperations 
public List<Order> findOrdersByType{Sstring t) { 


String type = t.equals{"NET") ? "WEB" : t; 


Criteria where = Criteria.wherel("'type") .is{(t); < 创建 查 询 
Query query = Query.query (where) ; 





return mongo.find(gquery, Order.class); < 执行 查 询 


可 以 看 到 ， 混 合 实现 中 注入 了 Mongooperations (也 就 
是 MongoTemplate 所 实现 的 接口 ) 。findordersByType() 方 法 使 
用 Mongo0perations 对 数据 库 进行 了 查询 ， 查 找 匹 配 条 件 的 文档 。 


剩 下 的 工作 就 是 修改 0rderRepository， 让 其 扩展 中 间接 口 
OrderOperations: 








public interface OrderRepository 
extends MongoRepository<Order, String>, OrderOperations { 








将 这 些 关 联 起 来 的 关键 点 在 于 实现 类 的 名 称 

为 OrderRepositoryImpl。 这 个 名 字 前 半 部 分 与 OrderRepository 相 
同 ， 只 是 添加 了 “Impl* 后 级 。 当 Spring Data MongoDB 生 成 Repository 实 
现时 ， 它 会 得 找 这 个 类 并 将 其 混合 到 上 自动 生成 的 实现 中 。 


如 果 你 不 喜欢 “mpl” 后 组 的 话 ， 那 么 可 以 配置 Spring Data MongoDB， 让 
其 按照 名 字 碍 找 具 备 不 同 后 绥 的 类 。 我 们 需要 做 的 就 是 设 
置 @EnableMongoRepositories 的 属性 〈 在 Spring 配置 类 中 ) : 














@Configuration 
@EnableMongoRepositories(basePpackages="orders.db", 


repositoryImplementationpostfix="Stuff") 
public class MongoConfig extends AbstractMongoConfiguration { 





es 


如 果 使 用 XML 配置 的 话 ， 我 们 可 以 设置 <mongo:repositories> 的 
repository-impl-postfix 属 性 : 


<mongo:repositories base-package="orders.db" 


repository-impl-postfix="Stuff" /> 





不 管 采 用 哪 种 方式 ， 我 们 现在 都 让 Spring Data MongoDB 查 找 名 
为 OrderRepositoryStuff 的 类 ， 而 不 再 查 
找 OrderRepositoryImp1。 


像 MongoDB 这 样 的 文档 数据 库 能 够 解决 特定 类 型 的 问题 ， 但 是 吏 像 关 
系 型 数据 库 不 是 全 能 型 数据 库 那 样 ，MongoDB 同 样 如 此 。 有 些 问题 并 
不 是 天 系 型 数据 库 或 文档 型 数据 库 适 合 解决 的 ， 不 过 ， 笠 好 我 们 的 选择 
并 不 仅 限 于 这 两 种 。 


接 下 来 ， 我 们 看 一 下 Spring Data 如 何 文 持 Neo4j， 这 是 一 种 很 流行 的 图 
数据 库 。 





12.2 ”使 用 Neo4j 操 作 图 数据 


文档 型 数据 库 会 将 数据 存储 到 粗 粒 度 的 文档 中 ， 而 图 数据 库 会 将 数据 存 
储 到 多 个 细 粒 度 的 节点 中 ， 这 些 节 点 之 间 通 过 关系 建立 关联 。 图 数据 库 
中 的 一 个 节点 通常 会 对 应 数据 库 中 的 一 个 概念 (concept) ， 它 会 具备 摘 
述 节 点 状态 的 属性 。 连 接 两 个 节点 的 关联 关系 可 能 也 会 带 有 属性 。 


按照 其 最 简单 的 形式 ， 图 数据 库 比 文档 数据 库 更 加 通用 ， 有 可 能 会 成 为 
关系 型 数据 库 的 无 模式 〈schemaless) 替代 方案 。 因 为 数据 的 结构 是 
图 ， 所 以 可 以 所 有 历 关 联 关系 以 碍 找 数据 中 你 所 关心 的 内 容 ， 这 在 其 他 数 
据 库 中 是 很 难 甚 至 无 法 实现 的 。 


Spring Data Neo4j 提 供 了 很 多 与 Spring Data JPA 和 Spring Data MongoDB 
相同 的 功能 ， 当 然 所 针对 的 是 Neo4j 图 数据 库 。 它 提供 了 将 Java 对 象 映 
射 到 节点 和 关联 关系 的 注解 、 面 向 模板 的 Neo4j 访 问 方式 以 及 Repository 
实现 的 自动 化 生成 功能 。 


我 们 稍 后 会 看 到 如 何在 Neo4j 中 使 用 这 些 特性 ， 不 过 首先 我 们 需要 配置 
Spring Data Neo4j 。 

















12.2.1 配置 Spring Data Neo4j 


配置 Spring Data Neo4j 的 关键 在 于 声明 GraphDatabaseService bean 和 
启用 Neo4j Repository 上 自动 生成 功能 。 如 下 的 程序 清单 展现 了 Spring Data 
Neo4j 所 需 的 基本 配置 。 


程序 清单 12.8 使 用 @EnableNeo4jRepositories 来 配置 Spring Data 
Neo4] 


Package orders.config; 








启用 
s Repository 
public J 4jConfig() { 自动 生成 功能 
setBasePackage ("orders"); 3 设 置 模型 
的 基础 包 





Bean (destroyMethod="shutdown") 
public GraphDatabasesSe raphDatabaseService() { 
return new GraphDatabaseFactory!) 
.newEmbeddedDatabase("/tmp/graphdb"); 4 配置 嵌入 
乓 类 人 [ 直 
式 数据 库 


@EnableNeo4jRepositories 注 解 能 够 让 Spring Data Neo4 和 自动 生 成 
Neo4j Repository 实 现 。 它 的 basePackages 属 性 设置 为 orders.db 包 ， 
这 样 它 就 会 扫 摘 这 个 包 来 查找 〈 直 接 或 间接 ) 扩展 Repository 标 记 接 
口 的 其 他 接口 。 


Neo4jConfig 扩 展 自 Neo4jConfiguration， 后 者 提供 了 多 个 便利 的 方 
法 来 配置 Spring Data Neo4j。 在 这 些 方法 中 ， 就 包括 
setBasePackage()， 它 会 在 Neo4jConfig 的 构造 器 中 调用 ， 用 来 告诉 
Spring Data Neo4j 要 在 orders 包 中 查找 模型 类 。 

















这 个 拼图 的 最 后 一 部 分 是 定义 GraphDatabaseServicebean。 在 本 例 
中 ，graphDatabaseService() 方 法 使 用 GraphDatabaseFactory 来 创 
建 舱 入 式 的 Neo4j 数 据 库 。 在 Neo4j 中 ， 租 入 式 数据 库 不 要 与 内 存 数 据 库 
相 混 淆 。 在 这 里 ,“ 骨 入 式 ” 指 的 是 数据 库 引 苟 与 应 用 运行 在 同一 个 JVM 
中 ， 作 为 应 用 的 一 部 分 ， 而 不 是 独立 的 服务 器 。 数 据 依然 会 持久 化 到 文 
件 系 统 中 《在 本 例 中 ， 也 就 是 “tmp/graphdb” 中 ) 。 


作为 另外 的 一 种 方式 ， 你 可 能 会 希望 配置 GraphDatabaseService 连 接 
远程 的 Neo4j 服 务 器 。 如 果 spring-data-neo4j-rest 库 在 应 用 的 类 路 
径 下 ， 那 么 我 们 就 可 以 配置 SpringRestGraphDatabase， 它 会 通过 
RESTful API 来 访问 远程 的 Neo4j 数 据 库 : 


@Bean(destroyMethod="shutdown") 
public GraphDatabaseService graphDatabaseService() { 





return new SpringRestGraphDatabase( 
"http://graphdbserver:7474/db/data/"); 
} 


如 上 所 示 ，SpringRestGraphDatabase 在 配置 时 ， 假 设 远程 的 数据 库 
并 不 需要 认证 。 但 是 ， 在 生产 环境 的 配置 中 ， 当 创建 
SpringRestGraphDatabase 的 时 候 ， 我 们 可 能 希望 提供 应 用 的 凭证 





@Bean(destroyMethod="shutdown") 
public GraphDatabaseService graphDatabaseService(Environment env) { 
return new SpringRestGraphDatabase( 


"http://graphdbserver:7474/db/data/", 
env.getproperty("db.username"), env.getProperty("db.password")); 





在 这 里 ， 和 凭证 是 通过 注入 的 Environment 获 取 到 的 ， 避 免 了 在 配置 类 中 
的 硬 编码 。 


Spring Data Neo4j 同 时 还 提供 了 XML 命名 空间 。 如 果 你 更 愿意 在 XML 中 
配置 Spring Data Neo4j 的 话 ， 那 可 以 使 用 该 命名 空间 中 的 

<neo4j :config> 和 <neo4j :repositories> 元 素 。 在 功能 上 ， 程 序 清 
单 12.9 所 展示 的 配置 与 程序 清单 12.8 中 的 Java 配 置 是 相同 的 。 


程序 清单 12.9 Spring Data Neo4j 也 可 以 通过 XML 来 配置 












rg/schema/beans" 
na-instanc 


g/schema/data/neo4j" 


ing-beans .xsd 


eo4j/spring-neo4ij.xsd"> 
. 配置 Neod; 
rapheb 数据 库 的 细节 





<neo4j:repositories base-package="orders.db" /> - 启用 Repository 生成 功能 


<neo4j :config> 元 素 配 置 了 如 何 访问 数据 库 的 细节 。 在 本 例 中 ， 它 配 
置 Spring Data Neo4j 使 用 藤 入 式 的 数据 库 。 有 具体 来 讲 ，storeDirectory 
属性 指定 了 数据 要 持久 化 到 哪个 文件 系统 路 径 中 。base-package 属 性 
设置 了 模型 类 定义 在 哪个 包 中 。 





至 于 <neo4j :repositories> 元 素 ， 它 局 用 Spring Data Neo4j 上 自动 生成 
Repository 实 现 的 功能 ， 它 会 扫描 orders .db 包 ， 碍 找 所 有 扩 
展 Repository 的 接口 。 


如 果 要 配置 Spring Data Neo4j 访 问 远程 的 Neo4j 服 务 器 ， 我 们 所 需要 做 的 
就 是 声明 SpringRestGraphDatabasebean， 并 设置 <neo4j:config> 
的 graphDatabaseService 属 性 : 


<neo4j:config base-package="orders" 
graphDatabaseService="graphDatabaseService" /> 
<bean id="graphDatabaseService" class= 
"org.springframework.data.neo4j.rest.SpringRestGraphDatabase"> 


<constructor-arg value="http://graphdbserver:7474/db/data/" /> 
<Constructor-arg value="db.username" /> 
<constructor-arg value="db.password" /> 

</bean> 





不 管 是 通过 Java 还 是 通过 XML 来 配置 Spring Data Neo4j ， 我 们 都 需要 确 
保 模型 类 位 于 基础 包 所 指定 的 包 中 (通过 @EnableNeo4jRepositories 
的 basePackages 属 性 或 cneo4j:config> 的 base-package 属 性 来 进行 
设置 ) 。 它 们 都 需要 使 用 注解 将 其 标注 为 节点 实体 或 关联 关系 实体 。 这 
就 是 我 们 接 下 来 的 任务 。 


12.2.2 使 用 注解 标注 图 实体 

Neo4j 定 义 了 两 种 类 型 的 实体 : 市 点 Cnode) 和 关联 关系 

Crelationship) 。 一 般 来 讲 ， 节 点 反映 了 应 用 中 的 事物 ， 而 关联 关系 定 
义 了 这 些 事 物 是 如 何 联系 在 一 起 的 。 


Spring Data Neo4j 提 供 了 多 个 注解 ， 它 们 可 以 应 用 在 模型 类 型 及 其 域 
上 ， 实 现 Neo4j 中 的 持久 化 。 表 12.3 摘 述 了 这 些 注解 。 


表 12.3 ”借助 Spring Data Neo4j 的 注解 ， 能 够 将 领域 类 型 映射 为 图 中 的 节点 和 关联 关系 








@NodeEntity 将 Java 类 型 声明 为 节点 实体 





@RelationshipEntity | 将 Java 类 型 声明 为 关联 关系 实体 


将 某 个 属性 声明 为 天 联 关 系 实体 的 开始 市 
re 人 属性 声明 为 关联 关系 实体 的 结束 节点 

将 实体 的 属性 声明 为 立即 加 载 

洲 属性 设置 为 实体 的 ID 域 〈 这 个 域 的 类 型 必须 大 


,| 声明 某 个 属性 会 自动 提供 一 个 iterable 元 素 ， 
ee 所 构建 的 


声明 某 个 属性 应 该 被 索引 



































声明 某 个 属性 会 自动 提供 一 个 iterable 元 素 ， 这 个 元 素 是 执行 给 
4 定 的 Cypher 查 询 所 构建 的 
声明 某 个 Java 或 接口 能 够 持 有 查询 的 结果 


通过 某 个 属性 ， 声 明 当 前 的 @NodeEntity 与 男 外 一 个 @NodeEntity 之 


在 @NodeEntity 上 声明 茶 个 属性 ， 指 定 其 引用 该 节点 所 属 的 某 一 


个 @RelationshipEntity 


将 某 个 域 声明 为 关联 实体 类 型 






































@RelatedToVia 








@ResultColumn 在 带 有 @QueryResult 注 解 的 类 型 上 ， 将 某 个 属性 声明 为 获取 得 
询 结果 集中 的 某 个 特定 列 








为 了 了 解 如 何 使 用 其 中 的 茶 些 注解 ， 我 们 会 将 其 应 用 到 订单 /条 目 样 例 


O 


在 该 样 例 中 ， 数 据 建 模 的 一 种 方式 束 是 将 订单 设 定 为 一 个 节点 ， 它 会 与 
一 个 或 多 个 条 目 关 联 。 图 12.2 以 图 的 形式 描述 了 这 种 模型 。 


Has items 





图 12.2 ”连接 两 个 节点 的 简单 关联 关系 ， 关 系 本 身 不 包含 任何 属性 
为 了 将 订单 指定 为 节点 ， 我 们 需要 为 Oorder 类 添加 @NodeEntity 注 解 。 
如 下 的 程序 清单 展现 了 带 有 @NodeEntity 注 解 的 Order 类 ， 它 还 包含 了 
表 12.3 中 的 几 个 其 他 注解 。 


程序 清单 12.10 ”为 Order 添 加 注解 ， 使 其 成 为 图 数据 库 中 的 一 个 布点 


package orders; 





import java.util.LinkedHashsSet:; 

import java.util.Set; 

import org.springframework.data.neo4j.annotation.GraphId; 
import org.springframework.data.neo4]j .annotation.NodeEntity; 


import org.springframework.data.neo4j .annotation.RelatedTo; 


@NodeEntity 4 Order 类 是 节点 
public class Order { 

@GraphIg 

@GraphId Graph ID 


private Long id; 
private String customer; 


private String type; 


QRelatedTo (type="HAS_ITEMS") : 与 条 日 之 间 的 关联 关 系 


private Set<Item> items = new LinkedHashSet<Item>(); 





除了 类 级 别 上 的 @NodeEntity， 还 要 注意 id 属 性 上 使 用 了 @GraphId 注 
解 。Neo4j 上 的 所 有 实体 必要 要 有 一 个 图 ID 。 这 大 致 类 似 于 JPA 
@Entity 以 及 MongoDB @Document 类 中 使 用 QId 注 解 的 属性 。 在 这 
里 ，@GraphId 注 解 标注 的 属性 必须 是 Long 类 型 。 


customer 和 type 属 性 上 没有 任何 注解 。 只 要 这 些 属性 不 是 瞬 态 的 ， 它 
们 都 会 成 为 数据 库 中 节点 的 属性 。 


items 属 性 上 使 用 了 @RelatedTo 注 解 ， 这 表明 Order 与 一 个 Item 的 Set 
存在 关联 关系 。type 属 性 实际 上 就 是 为 关联 关系 建立 了 一 个 文本 标记 。 
它 可 以 设置 成 任意 的 值 ， 但 通常 会 给 定 一 个 易于 人 类 阅读 的 文本 ， 用 来 
简单 摘 述 这 个 关联 关系 的 特征 。 稍 后 ， 你 将 会 看 到 如 何 将 这 个 标记 用 在 
查询 中 ， 实 现 跨 关联 关系 的 查询 。 


就 Item 本 身 来 说 ， 下 面 展 现 了 如 何 为 其 添加 注解 实现 图 的 持久 化 。 
程序 清单 12.11 Item 也 是 图 数据 库 中 的 节点 











ckage orders; 

port org.springframework.data.neo4j.annotation.GraphId; 
import org.springframework .data.neod4j.annotation.NodeEntity; 
@NodeEntity < Item 类 是 节点 
public class Item { 





Graph ID 
pr te Long id; 

pr String CE 
private do Es pric 
pr > int quantity; 


类 似 于 Order，Item 也 使 用 了 @NodeEntity 注 解 ， 将 其 标记 为 一 个 节 
点 。 它 同时 也 有 一 个 Long 类 型 的 属性 ， 借 助 @GraphId 注 解 将 其 标注 为 
节点 的 图 ID， 而 product、price 以 及 quantity 属 性 均 会 作为 图 数据 库 
中 节点 的 属性 。 


Order 和 Item 之 间 的 关联 关系 很 简单 ， 关 系 本 里 并 不 包含 任何 的 数据 。 
因此 ，@RelatedTo 注 解 束 是 以 定义 关联 关系 。 但 是 ， 并 个 是 所 有 的 天 
联 关 系 都 这 么 简单 。 


让 我 们 重新 考虑 该 如 何 为 数据 建 模 ， 从 而 学 习 如 何 使 用 更 为 复杂 的 关联 
关系 。 在 当前 的 数据 模型 中 ， 我 们 将 条 目 和 产品 的 信息 组 合 到 了 Item 类 
中 。 但 是 ， 当 我 们 重新 考虑 的 时 候 ， 会 发 现 订单 会 与 一 个 或 多 个 产品 相 
关联 。 订 单 与 产品 之 间 的 关系 构成 了 订单 的 一 个 条 目 。 图 12.3 描 述 了 男 
外 一 种 在 图 中 建 模 数据 的 方式 。 














Lineltem 
(has line items for) 


Quantity 











图 12.3 ”关联 关系 实体 自身 具有 属性 


在 这 个 新 的 模型 中 ， 订 单 中 产品 的 数量 是 条 目 中 的 一 个 属性 ， 而 产品 本 
映 是 为 外 一 个 概念 。 与 前 面 一 样 ， 订 单 和 产品 都 是 大 把， 而 条 目 是 关联 
关系 。 因 为 现在 的 条 目 必 须要 包含 一 个 数量 值 ， 关 联 关 系 不 像 前 面 那 么 
人 简单。 我 们 需要 定义 一 个 类 来 代表 条 目 ， 比 如 如 下 程序 清单 所 示 的 


LineItem。 











程序 清单 12.12 ”LineItem 类 连接 了 一 个 Order 节 点 和 一 个 Product 节 点 


package orders 
import org.springframework.data.neo4j.annotation.EndNode; 


import org.springframework.data.r .annotation.GraphId:; 





import org.springframework.data.neo4j.annotation.RelationshipEntity:; 


import org.springframework.data.neo4ij.annotation.StartNode; 


@RelationshipEntity (type="HAS_LINE_ITEM_FOR") 。 Lineltem 是 关联 关系 


public class LineItem { 


GGraphTIda < Graph ID 
private Long id; 


GStartNode 开始 节点 


private Order order; 


&EndNode 结束 节点 


private Product product; 


private int quantity; 
} 


Order 类 通过 @NodeEntity 注 解 将 其 标示 为 一 个 节点 ， 而 LineItem 类 则 
使 用 了 Q@RelationshipEntity 注 解 。LineItem 同 样 也 有 一 个 id 属性 标 
注 了 @GraphId 注 解 ， 不 管 是 节点 实体 还 是 关联 关系 实体 ， 都 必须 要 有 
一 个 图 ID， 而 且 其 类 型 必须 为 Long。 


关联 关系 实体 的 特殊 之 处 在 于 它们 连接 了 两 个 节点 。@StartNode 和 
@EndNode 注 解 用 在 定义 关联 关系 两 端的 属性 上 。 在 本 例 中 ，Order 是 开 
始 节 点 ，Product 是 结束 节点 。 


最 后 ，LineItem 类 有 一 个 quantity 属 性 ， 当 关联 关系 创建 的 时 候 ， 它 
会 持久 化 到 数据 库 中 。 


领域 对 象 已 经 添加 了 注解 ， 现 在 束 可 以 保存 与 读 取 节 点 和 关联 关系 了 。 
我 们 首先 看 一 下 如 何 使 用 Spring Data Neo4j 中 的 Neo4jTemplate 实 现 面 
癌 模 板 的 数据 访问 。 


12.2.3 ”使 用 Neo4jTemplate 


Spring Data MongoDB 提 供 了 MongoTemplate 实 现 基于 模板 的 MongoDB 

持久 化 ， 与 之 类 似 ，Spring Data Neo4j 提 供 了 Neo4jTemplate 来 操作 

Neo4j 图 数据 库 中 的 节点 和 关联 关系 。 如 果 你 已 经 按照 前 面 的 方式 配置 
了 Spring Data Neo4j， 在 Spring 应 用 上 下 文中 就 已 经 具备 了 一 

人 接 下 来 需要 做 的 就 是 将 其 注入 到 任意 想 使 用 它 
多 地 方 。 


例如 ， 我 们 可 以 直接 将 其 目 动 效 配 到 茶 个 bean 的 属性 上 : 


@Autowired 
private Neo4jOperations neo4]j; 


Neo4jTemplate 定 义 了 很 多 的 方法 ， 包 括 保 存 节 点 、 删 除 节 点 以 及 创建 
节点 间 的 关联 关系 。 我 们 没有 足够 的 篇 幅 介 绍 所 有 的 方法 ， 但 是 我 们 会 
看 一 下 Neo4jTemplate 所 提供 的 最 为 常用 的 方法 。 


我 们 想 借助 Neo4jTemp1late 完 成 的 最 基本 的 一 件 事 情 可 能 就 是 将 某 个 对 
象 保存 为 节点 。 假 设 这 个 对 象 已 经 使 用 了 Q@NodeEntity 注 解 ， 那 么 我 们 
可 以 按照 如 下 的 方式 来 使 用 save() 方 法 : 

















Order order = ...; 





2 
Order savedorder = neo4j.save(order); 





如 果 你 能 知道 对 象 的 图 ID， 那 么 可 以 通过 findOne( ) 方 法 来 获取 它 : 


Order order = neo4j.findOne(42, Order.class); 


如 果 按 照 给 定 的 ID 找 不 到 节点 的 话 ， 那 么 Findone( ) 方 法 将 会 抛 出 
NotFound(Exception)。 


如 果 你 想 获 取 给 定 类 型 的 所 有 对 象 ， 那 么 可 以 使 用 findAll0 方 法 : 


EndResult<Order> allorders = neo4j.findAll(Order.class); 


这 里 返回 的 EndResult 是 一 个 Iterable， 它 能 够 用 在 for-each 循 环 以 及 
任何 可 以 使 用 Iterable 的 地 方 。 如 果 不 存在 这 样 的 节点 的 
话 ，findAl1() 方 法 将 会 返回 空 的 Iterable。 


如 果 你 只 是 想 知 道 Neo4j 数 据 库 中 指定 类 型 的 对 象 数量 ， 那 么 就 可 以 调 
用 count() 方 法 : 


long orderCount = count(Order.class); 


delete( ) 方 法 可 以 用 来 删除 对 象 : 


neo4j.delete(order); 


createRelationshipBetween() 是 Neo4jTemplate 所 提供 的 最 有 意思 
的 方法 之 一 。 我 们 可 以 猿 到 ， 它 会 为 两 个 节点 创建 关联 关 系 。 例 如 ， 我 
们 可 以 在 Order 节 点 和 Product 节 点 之 间 建 并 LineItem 关 联 关 系 : 


Order order = ...; 
Product prod = ...; 
LineItem lineItem = neo4j.createRelationshipBetween( 
order, prod, LineItem.class, "HAS LINE ITEM FOR", false); 


lineItem.setQuantity(5); 
neo4j.save(lineItem); 





createRelationshipBetween() 方 法 的 前 两 个 参数 是 关联 关系 两 端的 
节点 对 象 。 接 下 来 的 参数 指定 了 使 用 @RelationshipEntity 注 解 的 类 
型 ， 它 会 代表 这 种 关系 。 接 下 来 的 String 值 描述 了 关联 关系 的 特征 。 最 
后 的 参数 是 一 个 boolean 值 ， 它 表明 这 两 个 节点 实体 之 间 是 否 人 允许 存在 
重复 的 关联 关系 。 


createRelationshipBetween() 会 返回 关联 关系 类 的 一 个 实例 。 通 过 
它 ， 我 们 可 以 设置 任意 的 属性 。 上 面 的 示例 中 设置 了 quantity 属 性 。 
当 这 一 切 完成 后 ， 我 们 调用 save() 方 法 将 关联 关系 保存 到 数据 库 中 。 


Neo4jTemplate 提 供 了 很 便利 的 方式 来 使 用 Neo4j 图 数据 库 中 的 节点 和 
关联 关系 。 但 是 ， 这 种 方式 需要 借助 Neo4jTemplate 编 写 自己 的 

















Repository 实 现 。 接 下 来 ， 我 们 看 一 下 Spring Data Neo4j 怎 样 为 我 们 目 动 
化 生成 Repository 实 现 。 


12.2.4 创建 自动 化 的 Neo4j Repository 


大 多 数 Spring Data 项 目 都 具备 的 最 棒 的 一 项 功能 就 是 为 Repository 接 口 目 
动 生成 实现 。 我 们 已 经 在 Spring Data JPA 和 Spring Data MongoDB 中 看 到 
了 这 项 功能 。Spring Data Neo4j 也 不 例外 ， 它 同样 支持 Repository 自 动 化 
生成 功能 。 


我 们 已 经 将 @EnableNeo4jRepositories 添 加 到 了 配置 中 ， 所 以 Spring 
Data Neo4j 已 经 配置 为 支持 自动 化 生成 Repository 的 功能 。 我 们 所 需要 做 
的 就 是 编写 接口 ， 如 下 的 OrderRepository 就 是 很 好 的 起 点 : 





package orders.db; 
import orders.Order; 


import org.springframework.data.neo4j.repository.GraphRepository; 


public interface OrderRepository extends GraphRepository<Order> {} 





与 其 他 的 Spring Data 项 目 一 样 ，Spring Data Neo4j 会 为 扩展 Repository 接 
口 的 其 他 接口 生成 Repository 方 法 实现 。 在 本 例 

中 ，0OrderRepository 扩 展 了 GraphRepository， 而 后 者 又 间接 扩展 
了 Repository 接 口 。 因 此 ，Spring Data Neo4j 将 会 在 运行 时 创建 
OrderRepository 的 实现 。 





注意 ，GraphRepository 使 用 Order 进 行 了 参数 化 ， 也 就 是 这 个 
Repository 所 要 使 用 的 实体 类 型 。 因 为 Neo4j 要 求 图 ID 的 类 型 为 Long,， 
此 在 扩展 GraphRepository 的 时 候 ， 没 有 必要 再 去 指定 ID 类 型 。 


现在 ， 我 们 就 能 够 使 用 很 多 通用 的 CRUD 操 作 ， 这 与 JpaRepository 和 
MongoRepository 所 提供 的 功能 类 似 。 表 12.4 描 述 了 扩 
展 GraphRepository 所 能 够 得 到 的 方法 。 




















表 12.4 通过 扩展 GraphRepository，Repository 接 口 能 够 继承 多 个 CRUD 操 作 ， 
它们 会 由 Spring Data Neo4j 自 动 实现 























long count( ) ; 


void delete(Iterable< ?extendsT> ) ; 


void delete(Long id); 


void delete(T) ; 


void deleteAll(); 


boolean exists(Long id); 


EndResult<T> findAll(); 


Iterable<T> findAll(Iterable<Long>); 


Page<T> findAll(Pageable); 


EndResult<T> findAll(Sort); 


EndResult<T> 


findAllBySchemaPropertyValue(String,Object); 


Iterable<T> findAllByTraversal(N, 
TraversalDescription); 


T findBySschemaPropertyValue (String,Object); 


T findone(Long); 


EndResult<T> query(String, 








返回 在 数据 库 中 ， 目 标 类 型 有 多 少 实 














删除 多 个 实体 


根据 ID， 删 除 一 个 实体 


删除 一 个 实体 


删除 目标 类 型 的 所 有 实体 








根据 指定 的 ID， 检 查实 体 是 否 存 在 


获取 目标 类 型 的 所 有 实体 


根据 给 定 的 ID， 获 取 目 标 类 型 的 实体 





目标 类 型 分 页 和 排序 后 的 实体 列 














目标 类 型 排序 后 的 实体 列表 





性 匹配 给 定 值 的 所 有 实体 












































性 匹配 给 定 值 的 一 个 实体 











根据 ID， 获 得 某 一 个 实体 





Map<String,Object>); 返回 匹配 给 定 Cypher 查 询 的 所 有 实体 








Iterable<T> save(Iterablex<T>); 保存 多 个 实体 





S save(S); 保存 一 个 实体 








我 们 没有 足够 的 篇 幅 介 绍 所 有 的 方法 ， 但 是 有 些 方 法 你 可 能 会 经 常用 
到 。 例 如 ， 如 下 的 代码 能 够 保存 一 个 Order 实 体 : 


Order savedOrder = orderRepository.save(order ) ; 


当 实 体 保 存 之 后 ，save() 方 法 将 会 返回 锌 保存 的 实体 ， 如 果 之 前 它 使 
用 @GraphId 注 解 的 属性 值 为 nul1 的 话 ， 此 时 这 个 属性 将 会 填 序 上 值 。 


我 们 还 可 以 使 用 findone() 方 法 查询 某 一 个 实体 。 例 如 ， 下 面 的 这 行 代 
人 码 将 会 查询 图 有 D 为 4 的 Order: 


Order order = orderRepository.findOne(4L); 


我 们 还 可 以 查询 所 有 的 Order: 


EndResult<Order> allorders = orderRepository.findAll(); 


当然 ， 你 可 能 还 希望 删除 某 一 个 实体 。 这 种 情况 下 ， 可 以 使 
用 delete() 方 法 : 


delete(order); 


这 将 会 从 数据 库 中 删除 给 定 的 0rder 节 点 。 如 果 你 只 有 图 ID 的 话 ， 那 可 
以 将 其 传递 到 delete( ) 方 法 中 ， 而 不 是 再 使 用 市 上 类 型 本 刁 : 


delete(orderId); 


如 果 你 希望 进行 目 定义 的 查询 ， 那 么 可 以 使 用 query() 方 法 对 数据 库 执 
行 任意 的 Cypher 人 查询 。 但 是 这 与 使 用 Neo4jTemplate 的 query() 方 法 并 




















没有 六 大 的 差别 。 其 实 ， 我 们 还 可 以 为 OrderRepository 添 加 目 定义 
的 查询 方法 。 


添加 查询 方法 

我 们 已 经 看 过 如 何 按照 命名 约定 使 用 Spring Data JPA 和 Spring Data 
MongoDB 来 添加 自 定义 的 查询 方法 。 如 果 Spring Data Neo4j 没 有 提供 相 
同 功 能 的 话 ， 那 我 们 就 该 失望 了 。 

如 下 面 的 程序 清单 所 示 ， 其 实 我 们 完全 没有 必要 失望 : 

程序 清单 12.13 ”通过 遵循 命名 约定 来 定义 查询 方法 





K orde 上 
1mF ava List 
imp de jer 
m n am Ei 地 neo4]j r r Repo ry 
public interface OrderRepository extends GraphRepository<Order> 1{ 


查询 方法 





ist<order> findBy 


List<Order> findByCustomerAndTypelString customer, String type); 


stomer (String customer); 


} 


这 里 ， 我 们 添加 了 两 个 方法 。 其 中 一 个 会 查询 customer 属 性 等 于 给 定 
String 值 的 Order 节 点 。 另 外 一 个 方法 与 之 类 似 ， 但 是 除了 匹 

配 customer 属 性 以 外 ，0Order 节 点 的 type 属 性 必须 还 要 等 于 给 定 的 类 
型 值 。 


我 们 之 前 已 经 讨论 过 查询 方法 的 命名 约定 ， 所 以 这 里 没有 必要 再 进行 深 
入 地 讨论 。 可 以 翻 看 之 前 学 习 Spring Data JPA 的 章节 ， 重 新 温习 如 何 编 
写 这 此 方太 


指定 自 定 义 碍 询 


当 命 名 约定 无 法 满足 需求 时 ， 我 们 还 可 以 为 方法 添加 @Query 注 解 ， 为 
其 指定 自 定义 的 查询 。 我 们 之 前 已 经 见 过 @Query 注 解 。 在 Spring Data 
JPA 中 ， 我 们 使 用 它 来 为 Repository 方 法 指定 JPA 查 询 。 在 Spring Data 
MongoDB 中 ， 我 们 使 用 它 来 指定 匹配 JSON 的 查询 。 但 是 ， 在 使 用 
Spring Data Neo4j 的 时 候 ， 我 们 必须 指定 Cypher 碍 询 : 














@Query("match (o:Order)-[:HAS ITEMS]->(i:Item) " + 


"where i.product='Spring in Action' return o") 
List<Order> findSiAOrders(); 





在 这 里 ，findSiAOrders() 方 法 上 使 用 了 @Query 注 解 ， 并 设置 了 一 个 
Cypher 仁 询 ， 它 会 查找 与 Ttem 关 联 并 且 product 属 性 等 于 “Spring in 
Action” 的 所 有 Order 节 点 。 





混合 自 定义 的 Repository 行 为 

当 命 名 约定 和 @Query 注 解 均 无 法 满足 满足 需求 的 时 候 ， 我 们 还 可 以 混 
合 自 定义 的 Repository 逻 辑 。 

例如 ， 假 设 我 们 想 自己 编写 findSiAOrders() 方 法 的 实现 ， 而 不 是 依 


束 于 @Query 注 解 。 那 么 可 以 首先 定义 一 个 中 间接 口 ， 该 接口 包 
含 findSiAOrders() 方 法 的 定义 : 





package orders .db 
import java.util.List; 
import orders.Order; 


public interface OrderOperations { 
List<Order> findSiAOrders(); 
} 





然后 ， 我 们 修改 0rderRepository， 让 它 扩 展 Orderoperations 和 
GraphRepository: 


public interface OrderRepository 
extends GraphRepository<Order>, OrderOperations { 











最 后 ， 我 们 需要 自己 编写 实现 。 与 Spring Data JPA 和 Spring Data 
MongoDB 类 似 ，Spring Data Neo4j 将 会 查找 名 字 与 Repository 接 口 相同 且 





添加 “Impl 后 绥 的 实现 类 。 因 此 ， 我 们 需要 创建 
OrderRepositoryImpl 类 。 如 下 的 程序 清单 展示 了 
OrderRepositoryImpl 类 ， 它 实现 了 findSiAOrders() 方 法 。 


程序 清单 12.14 将 自 定 义 功 能 混合 到 OrderRepository 中 


package orders .db; 

import java.util.Collections; 
import java.util.List; 

import java.util.Map; 

import orders.Order; 


import org.neo4]j.helpers.collection.IteratorUti]l; 























import org.springfrsa ork.beans.factory.annotation.Autowired; 
import org.springfram rk.data.neo conversion.EndResult; 


import org.springframework.data.neo4]j.conversion.Result; 


实现 
中 间接 口 


import org.springframework.data.neo4ij.template.Neo4ijOperations; 
public class OrderRepositoryImpl implements OrderOperations { 4 


private final Neo4jOperations neo4j; 


@Autowired 注入 
public OrderRepositoryImpl (Neo4jOperations neo4j)} { < Neo4jOperations 
this.neo4j = neo4j; 
} 
public List<Order> findSiAOrders() { 
Result<Map<String, Object>> result = neo4]j .Guery( < 执行 查询 
"match (o:Order)-[:HAS_ITEMS]->(i:Item) " + 


"where i.product='Spring in Action’' return o", 


EndResult<Order> endResult = result.to(Order.class);  :* 转换 为 

return IteratorUti asList (endResu 4 EF e < eI> 

i IteratorUtil.asList (endResult); + 转换 为 EndResult<Order 
List<Order> 


OrderRepositoryImpl 中 注入 了 一 个 Neo4jOperations (具体 来 讲 ， 
就 是 Neo4jTemplate 的 实例 ) ， 它 会 用 来 查询 数据 库 。 因 为 query() 方 
法 返回 的 是 Result<Map<String，0bject>>， 我 们 需要 将 其 转换 
为 List<Order>。 第 一 步 是 调用 Result 的 to() 方 法 ， 产 生 一 

个 EndResult<Order>。 然 后 ， 使 用 Neo4j 的 IteratorUtil.asList() 
方法 将 EndResult<Order> 转 换 为 List<Order>， 然 后 将 其 返回 。 


对 于 能 够 表达 为 节点 和 关联 藉 系 的 数据 ， 像 Neo4j 这 样 的 图 数据 库 是 非 
常 合适 的 。 如 果 将 我 们 生活 的 世界 理解 为 各 种 互相 关联 的 事物 ， 那 么 图 
数据 库 能 够 适用 于 很 大 的 范围 。 就 我 个 人 而 言 ， 我 非常 喜欢 Neo4j。 


但 有 些 时 候 ， 我 们 需要 的 数据 会 更 简单 一 些 。 有 时 ， 我 们 所 需要 的 仅仅 
将 某 个 value 存 储 起 来 ， 稍 后 能 够 根据 一 个 key 将 其 提取 出 来 。 接 下 来 ， 
一 下 Spring Data 如 何 使 用 Redis key-value 存 储 实 现 这 种 类 型 的 数 
据 持久 化 。 














12.3 ”使 用 Redis 探 作 key-value 数 据 


Redis 是 一 种 特殊 类 型 的 数据 库 ， 它 被 称 之 为 key-value 存 储 。 顾 名 思 
义 ，key-value 存 储 保存 的 是 键 值 对 。 实 际 上 ，key-value 存 储 与 哈 希 Map 
有 很 大 的 相似 性 。 可 以 不 太 夸 张 地 说 ， 它 们 束 是 持久 化 的 哈 希 Map。 


当 你 思考 这 一 点 的 时 候 ， 可 能 会 意识 到 ， 对 于 哈 希 Map 或 者 key-value 存 
储 来 说 ， 其 实 并 没有 太 多 的 操作 。 我 们 可 以 将 某 个 value 存 储 到 特定 的 
key 上 ， 并 且 能 够 根据 特定 key， 获 取 value。 差 不 多 也 束 是 这 样 了 。 
此 ，Spring Data 的 目 动 Repository 生 成 功能 并 没有 应 用 到 Redis 上。 不 
过 ，Spring Data 的 另外 一 个 关键 特性 ， 也 就 是 面 同 模板 的 数据 访问 ， 能 
够 在 使 用 Redis 的 时 候 ， 为 我 们 提供 帮助 。 


Spring Data Redis 包 含 了 多 个 模板 实现 ， 用 来 完成 Redis 数 据 库 的 数据 存 
取 功 能 。 稍 后 ， 我 们 就 会 看 到 如 何 使 用 它们 。 但 是 为 了 创建 Spring Data 
Redis 的 模板 ， 我 们 首先 需要 有 一 个 Redis 连 接 工 厂 。 竺 好 ，Spring Data 
Redis 提 供 了 四 个 连接 工矿 供 我 们 选择 。 








12.3.1 连接 到 Redis 


Redis 连 接 工 三 会 生成 到 Redis 数 据 库 服 务 器 的 连接 。Spring Data Redis 为 
四 种 Redis 客 户 端 实现 提供 了 连接 工厂 : 


e。 JedisConnectionFactory 

e JredisConnectionFactory 
e。 LettuceConnectionFactory 
e。 SrpConnectionFactory 


具体 选择 哪 一 个 取决 于 你 。 我 建议 你 自行 测试 并 建立 基准 ， 进 而 确定 哪 
一 种 Redis 客 户 端 和 连接 工厂 最 适合 你 的 需求 。 从 Spring Data Redis 的 角 
度 来 看 ， 这 些 连 接 工矿 在 适用 性 上 都 是 相同 的 。 


在 做 出 决策 之 后 ， 我 们 就 可 以 将 连接 工厂 配置 为 Spring 中 的 bean。 例 
如 ， 如 下 展示 了 如 何 配置 JedisConnectionFactory bean: 


@Bean 





public RedisConnectionFactory redisCF() { 
return new JedisConnectionFactory(); 


} 


通过 默认 构造 器 创建 的 连接 工 三 会同 localhost 上 的 6379 端 口 创建 连接 ， 
并 且 没有 密码 。 如 宁 你 的 Redis 服 务 器 运行 在 其 他 的 主机 或 端口 上 ， 在 
创建 连接 工厂 的 时 候 ， 可 以 设置 这 些 属性 : 


@Bean 
public RedisConnectionFactory redisCF() { 
JedisConnectionFactory cf = new JedisConnectionFactory(); 


cf.setHostName("redis-server"); 
cf.setPort(7379 ) ; 
return cf; 





类 似 地 ， 如 果 你 的 Redis 服 务 器 配置 为 需要 客户 端 认 证 的 话 ， 那 么 可 以 
通过 调用 setPassword() 方 法 来 设置 密码 : 


@Bean 

public RedisConnectionFactory redisCF() { 
JedisConnectionFactory cf = new JedisConnectionFactory(); 
cf.setHostName("redis-server"); 
cf.setPort(7379); 
cf.setPpassword("foobared"); 
return cf; 





在 上 面 的 这 些 例子 中 ， 我 都 假设 使 用 的 是 JedisConnectionFactory。 
如 末 你 选择 使 用 其 他 连接 工 太 的话 ， 只 需 进 行 简单 地 蔡 换 就 可 以 了 。 例 
如 ， 假 设 你 要 使 用 LettuceConnectionFactory 的 话 ， 可 以 按照 如 下 的 
方式 进行 配置 : 


@Bean 

public RedisConnectionFactory redisCF() { 
JedisConnectionFactory cf = new LettuceConnectionFactory() ; 
cf.setHostName("redis-server"); 


cf.setPort(7379); 
cf.setPpassword("foobared"); 
return cf; 





所 有 的 Redis 连 接 工 厂 都 具有 setHostName()、setPort() 和 
setPassword() 方 法 。 这 样 ， 它 们 在 配置 方面 实际 上 是 相同 的 。 


现在 ， 我 们 有 了 Redis 连 接 工 厂 ， 接 下 来 就 可 以 使 用 Spring Data Redis 模 
板 了 。 





12.3.2 ”使 用 RedisTemplate 


顾名思义 ，Redis 连 接 工 厂 会 生成 到 Redis key-value 存 储 的 连接 〈 以 

RedisConnection 的 形式 ) 。 借 助 RedisConnection， 可 以 存储 和 读 

例如 ， 我 们 可 以 获取 连接 并 使 用 它 来 保存 一 个 问候 信息 ， 如 下 
外: 





RedisConnectionFactory cf = ...; 


RedisConnection conn = cf.getConnection(); 
conn.set("greeting" .getBytes()， "Hello World".getBytes()); 








与 之 类 似 ， 我 们 还 可 以 使 用 RedisConnection 来 获取 之 前 存储 的 问候 


百世 \、: 


byte[] greetingBytes = conn.get("greeting".getBytes()); 





String greeting = new String(greetingBytes ) ; 





坚 无 疑问 ， 这 可 以 正常 运行 ， 但 是 你 难道 真 的 愿意 使 用 字 市 数组 吗 ? 


与 其 他 的 Spring Data 项 目 类 似 ，Spring Data Redis 以 模板 的 形式 提供 了 较 
高 等 级 的 数据 访问 方案 。 实 际 上 ，Spring Data Redis 提 供 了 两 个 模板 : 





e RedisTemplate 
。 StringRedisTemplate 


RedisTemplate 可 以 极 大 地 简化 Redis 数 据 访问 ， 能 够 让 我 们 持久 化 各 

种 类 型 的 key 和 value， 并 不 局 限于 字 节 数组 。 在 认识 到 key 和 value 通 常 

怎 String 基 型 之 后 ， StringRedisTemplate 扩 展 了 RedisTemplate,， 
只 关注 String 类 型 。 


假设 我 们 已 经 有 了 RedisConnectionFactory， 那 么 可 以 按照 如 下 的 方 
式 构 建 RedisTemplate: 


RedisConnectionFactory cf = ...; 
RedisTemplate<String, Product> redis = 


new RedisTemplate<String，Product>() ; 
Fedis.setConnectionFactory(cf) ; 





注意 ，RedisTemplate 使 用 两 个 类 型 进行 了 参数 化 。 第 一 个 是 key 的 类 
型 ， 第 二 个 是 value 的 类 型 。 在 这 里 所 构建 的 RedisTemplate 中 ， 将 会 
保存 Product 对 象 作为 value， 并 将 其 赋予 一 个 String 类 型 的 key。 


如 果 你 所 使 用 的 value 和 key 都 是 string 类 型 ， 那 么 可 以 考虑 使 
用 StringRedisTemplate 来 代替 RedisTemp1late: 


RedisConnectionFactory cf 


a 
StringRedisTemplate redis new StringRedisTemplate(cf); 





注意 ， 与 RedisTemplate 不 同 ，StringRedisTemplate 有 一 个 接受 
RedisConnectionFactory 的 构造 器 ， 因 此 没有 必要 在 构建 后 再 调 


用 setConnectionFactory()。 


尽管 这 并 非 必须 的 ， 但 是 如 果 你 经 常 使 用 RedisTemplate 

或 stringRedisTemplate 的 话 ， 你 可 以 考虑 将 其 配置 为 bean， 然 后 注 
入 到 需要 的 地 方 。 如 下 就 是 一 个 声明 RedisTemplate 的 简单 @Bean 方 
法 : 


@Bean 
public RedisTemplate<String, Product> 
redisTemplate(RedisConnectionFactory cf) { 
RedisTemplate<String, Product> redis = 
new RedisTemplate<String, Product>(); 
redis.setConnectionFactory(cf); 
return redis; 


} 





如 下 是 声明 StringRedisTemplate bean 的 @Bean 方 法 : 


@Bean 
public StringRedisTemplate 


stringRedisTemplate(RedisConnectionFactory cf) { 
return new StringRedisTemplate(cf); 


} 





有 J 了 RedisTemplate (或 stringRedisTemplate) 之 后 ， 我 们 就 可 以 
开始 保存 、 获 取 以 及 删除 key-value 条 目 了 。RedisTemplate 的 大 多 数控 
作 都 是 表 12.5 中 的 子 API 提 供 的 。 


表 12.5 “RedisTemplate 的 很 多 功能 是 以 子 API 的 形式 提供 的 ， 它 们 区 分 了 单个 值 和 集合 值 的 场 


慎 
操作 具有 ZSet 值 〈 排 序 的 set) 的 条 目 
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以 色 定 指定 key 的 广 式 ， 
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2 和 
boundsetops(K) BoundSetOperations<K,V> 1 定 key 的 方 式 ， 











, 以 绑 定 指定 key 的 方式 ， 
boundZzset(K) BoundZzSetOperations<K,V> (排序 的 set) 的 条 目 

















以 绑 定 指定 key 的 方式 ， 


\ 
pa 


boundHashOps(K) |BoundHashOperations<K,V> 


我 们 可 以 看 到 ， 表 12.5 中 的 子 API 能 够 通过 RedisTemplate (和 

StringRedis-Template) 进行 调用 。 其 中 每 个 子 API 都 提供 了 使 用 数 

基于 value 中 所 包含 的 是 单个 值 还 是 一 个 值 的 集合 它们 会 
2 


这 些 子 API 中 ， 包 含 了 很 多 从 Redis 中 存 取 数据 的 方法 。 我 们 没有 足够 的 
篇 幅 介 绍 所 有 的 方法 ， 但 是 会 介绍 一 些 最 为 常用 的 操作 。 


使 用 简单 的 值 


假设 我 们 想 通 过 RedisTemplate<String，Product> 保 存 Product， 其 
中 key 是 sku 属 性 的 值 。 如 下 的 代码 片段 展示 了 如 何 借助 
opsForValue() 方 法 完成 该 功能 : 


redis.opsForValue().set(product.getSku(), product); 


类 似 地 ， 如 果 你 希望 获取 sku 属 性 为 123456 的 产品 ， 那 么 可 以 使 用 如 下 
的 代码 片段 : 


Product product = redis.opsForValue().get("123456"); 
如 果 按 照 给 定 的 key， 无 法 获得 条 目的 话 ， 将 会 返回 null。 
使 用 List 类 型 的 值 


使 用 List 类 型 的 value 与 之 类 似 ， 只 需 使 用 opsForList() 方 法 即 可 。 例 
如 ， 我 们 可 以 在 一 个 List 类 型 的 条 目 尾部 添加 一 个 值 : 


redis.opsForList().rightpush("cart", product); 


通过 这 种 方式 ， 我 们 同 列 表 的 尾部 添加 了 一 个 Product， 上 所 使 用 的 这 个 
列表 在 存储 时 key 为 cart。 如 果 这 个 key 尚 未 存在 列表 的 话 ， 将 会 创建 一 
| 











rightPush() 会 在 列表 的 尾部 添加 一 个 元 素 ， 而 leftPush() 则 会 在 列 
表 的 头 部 添加 一 个 值 : 


redis.opsForList().leftPush("cart", product); 











我 们 有 很 多 方式 从 列表 中 获取 元 素 ， 可 以 通过 leftPop() 
或 rightPop() 方 法 从 列表 中 弹出 一 个 元 素 : 


Product first = redis.opsForList().leftPpop("cart"); 


Product last = redis.opsForList().rightPpop("cart"); 


除了 从 列表 中 获取 值 以 外 ， 这 两 个 方法 还 有 一 个 副作用 就 是 从 列表 中 移 








除 所 弹出 的 元 素 。 如 果 你 只 是 想 获 取 值 的 话 〈 甚 至 可 能 要 在 列表 的 中 间 
获取 ) ， 那 么 可 以 使 用 range() 方 法 : 


List<Product> products = redis.opsForList().range("cart", 2, 12); 


range( ) 方 法 不 会 从 列表 中 移 除 任何 元 素 ， 但 是 它 会 根据 指定 的 key 和 
索引 范围 ， 获 取 范 围 内 的 一 个 或 多 个 值 。 前 面 的 样 例 中 ， 会 获取 11 个 元 
素 ， 从 索引 为 2 的 元 素 到 索引 为 12 的 元 素 〈 不 包含 ) 。 如 果 范 围 超出 了 
列表 的 边界 ， ee 如 果 该 索引 范围 内 没 
有 元 素 的 话 ， 将 会 返回 一 个 空 的 列表 。 


在 Set 上 执行 操作 


除了 操作 列表 以 外 ， 我 们 还 可 以 使 用 opsForset() 操 作 Set。 最 为 常用 
的 操作 就 是 向 Set 中 添加 一 个 元 素 : 


redis.opsForSet().add("cart", product); 


在 我 们 有 多 个 Set 并 填充 值 之 后 ， 就 可 以 对 这 些 Set 进 行 一 些 有 意思 的 操 
作 ， 如 获取 其 差异 、 求 交集 和 求 并 集 : 











List<Product> diff = redis.opsForSet().difference("cart1", "cart2"); 
List<Product> union = redis.opsForSet().union("cart1", "cart2"); 
List<Product> isect = redis.opsForSet().isect("cart1", "cart2"); 





当然 ， 我 们 还 可 以 移 除 它 的 元 素 : 


redis.opsForSet() .remove(product ) ; 


我 们 甚至 还 可 以 随机 获取 Set 中 的 一 个 元 素 : 


Product random = redis.opsForSet().randomMember("cart"); 


因为 Set 没 有 索引 和 内 部 的 排序 ， 因 此 我 们 无 法 精准 定位 某 个 点 ， 然 后 
从 Set 中 获取 元 素 。 


绑 定 到 某 个 key 上 


表 12.5 包 含 了 五 个 子 API， 它 们 能 够 以 绑 定 key 的 方式 执行 操作 。 这 些 子 
API 与 其 他 的 API 是 对 应 的 ， 但 是 关注 于 某 一 个 给 定 的 key。 


为 了 举例 曾 述 这 些 子 API 的 用 法 ， 我 们 假设 将 Product 对 象 保存 到 一 个 
list 中 ， 并 且 key 为 cart。 在 这 种 场景 下 ， 假 设 我 们 想 从 list 的 右 侧 弹 出 一 
个 元 素 ， 然 后 在 list 的 尾部 新 增 三 个 元 素 。 我 们 此 时 可 以 使 
用 boundListOps() 方 法 所 返回 的 BoundListOperations: 


BoundListOperations<String, Product> cart = 
redis.boundListOps("cart"); 
Product popped = cart.rightPpop(); 


cart.rightpush(product1); 
cart.rightpush(product?2); 
cart.rightpush(product3); 





注意 ， 我 们 只 ea 也 就 是 调 
用 boundListops() 的 时 候 。 对 返回 的 BoundListoperations 执 行 的 所 
有 操作 都 会 应 用 到 这 个 key 上 。 


12.3.3 ”使 用 key 和 value 的 序列 化 器 

当 某 个 条 目 保 存 到 Redis key-value 存 储 的 时 候 ，key 和 value 都 会 使 用 
Redis 的 序列 化 器 (serializer〉 进行 序列 化 。Spring Data Redis 提 供 了 多 
个 这 样 的 序列 化 器 ， 包 括 : 


。GenericToStringSerializer: 使 用 Spring 转换 服务 进行 序列 





化 ; 

。 JacksonJsonRedisSerializer: 使 用 Jackson 1， 将 对 象 序列 化 为 
JSON ; 

。Jackson2JsonRedisSerializer: 使 用 Jackson 2， 将 对 象 序列 化 
为 JSON; 


。JdkSerializationRedisSerializer: 使 用 Java 序 列 化 ; 


。 OxmSerializer: 使 用 Spring O/X 映 射 的 编排 器 和 人 解 排 嚣 
(marshaler 和 unmarshaler〉 实现 序列 化 ， 用 于 XML 序 列 化 ; 
。StringRedisSerializer: 序列 化 String 类 型 的 key 和 value。 


些 序列 化 器 都 实现 了 Redisserializer 接 口 ， 如 果 其 中 没有 符合 
求 的 序列 化 器 那么 你 还 可 以 自行 创建 。 


RedisTemplate 会 使 用 JdkSerializationRedisSerializer， 这 意味 
着 key 和 value 都 会 通过 Java 进 行 序列 化 。SstringRedisTemplate 默 认 会 
使 用 StringRedis-Serializer， 这 在 我 们 的 预料 之 中 ， 它 实际 上 就 是 
实现 String 与 byte 数 组 之 间 的 相互 转换 。 这 些 默 认 的 设置 适用 于 很 多 
人 


例如 ， 假 设 当 使 用 RedisTemplate 的 时 候 ， 我 们 希望 将 Product 类 型 的 
value 序 列 化 为 JSON， 而 key 是 String 类 型 。RedisTemplate 的 
setKeySerializer() 和 setValueSerializer() 方 法 就 需要 如 下 所 
外: 





@Bean 
public RedisTemplate<String, Product> 
redisTemplate(RedisConnectionFactory cf) { 
RedisTemplate<String, Product> redis = 
new RedisTemplatex<String, Product>(); 


redis.setConnectionFactory(cf); 
redis.setKeySerializer(new StringRedisSerializer()); 
redis.setValueSerializer( 

new Jackson2JsonRedisSerializer<Product>(Product.class)); 
return redis; 





在 这 里 ， 我 们 设置 RedisTemplate 在 序列 化 key 的 时 候 ， 使 
用 stringRedisSerializer， 并 且 也 设置 了 在 序列 化 Product 的 时 
候 ， 使 用 Jackson2JsonRedisSserializer。 


12.4 小结 


关系 型 数据 库 作 为 数据 持久 化 领域 唯一 可 选 方案 的 时 代 已 经 一 去 不 返 
了 。 现 在 ， 我 们 有 多 种 不 同 的 数据 库 ， 每 一 种 都 代表 了 不 同形 式 的 数 
据 ， 并 提供 了 适应 多 种 领域 模型 的 功能 。Spring Data 能 够 让 我 们 在 
Spring 应 用 中 使 用 这 些 数据 库 ， 并 且 使 用 一 致 的 抽象 方式 访问 各 种 数据 


库 方 案 。 


在 本 章 中 ， 我 们 基于 前 一 章 使 用 JPA 时 所 学 到 的 Spring Data 知 识 ， 将 其 
应 用 到 了 MongoDB 文 档 数据 库 和 Neo4j 图 数据 库 中 。 与 JPA 对 应 的 功能 
类 似 ，Spring Data MongoDB 和 Spring Data Neo4j 项 目 都 提供 了 基于 接口 
定义 自动 生成 Repository 的 功能 。 除 此 之 外 ， 我 们 还 看 到 了 如 何 使 用 
Spring Data 所 提供 的 注解 将 领域 模型 映射 为 文档 、 节 点 和 关联 关系 。 


Spring Data 还 文 持 将 数据 持久 化 到 Redis key-value 存 储 中 。Key-value 存 
储 明 显要 简单 一 些 ， 因 此 没有 必要 文 持 自动 化 Repository 和 了 映射 注解 。 
不 过 ，Spring Data Redis 还 是 提供 了 两 个 不 同 的 模板 类 来 使 用 Redis key- 
value 存 储 。 


不 管 你 选择 使 用 哪 种 数据 库 ， 从 数据 库 中 获取 数据 都 是 消耗 成 本 的 操 

作 。 实 际 上 ， 数 据 库 碍 询 是 很 多 应 用 最 大 的 性 能 瓶颈 。 我 们 已 经 看 过 了 

如 何 通 过 各 种 数据 源 存储 和 获取 数据 ， 现 在 看 一 下 如 何 避 免 出 现 这 种 憩 

J 我 们 将 会 看 到 如 何 借助 声明 式 缓存 避免 不 必要 的 数据 
查询 。 











[1] Henry Ford 与 Samuel Crowther 着 《我 的 生活 与 工作 》 (Garden City, 
New York: Garden City Publishing Company, 1922) 


第 13 章 ”缓存 数据 


本 章 内 容 : 


。 局 用 声明 式 绥 存 下 
。 使 用 Ehcache、Redis 和 GemFire 实 现 绥 存 功能 
。 注解 驱动 的 缓存 


你 有 没有 过 到 过 有 人 反复 问 你 同一 个 问题 的 场景 ， 你 刚刚 给 出 完 解 答 ， 
马上 就 会 被 问 相 同 的 问题 ?我 的 孩子 经 第 会 问 我 这 样 的 问题 : 


“我 能 吃 点 糖 吗 ? ” 
“现在 几 扣 了 ? ” 
“我 们 到 了 吗 ? ” 
“我 能 吃 点 糖 吗 ? ” 


在 很 多 方面 看 来 ， 在 我 们 所 编写 的 应 用 中 ， 有 些 的 组 件 也 是 这 样 的 。 无 
状态 的 组 件 一 般 来 讲 扩 展 性 会 更 好 一 些 ， 但 它们 也 会 更 加 倾向 于 一 遍 遍 
地 问 相 同 的 问题 。 因 为 它们 是 无 状态 的 ， 所 以 一 旦 当前 的 任务 完成 ， 就 
会 丢弃 掉 已 经 获取 到 的 所 有 解答 ， 下 一 次 需要 相同 的 答案 时 ， 它 们 就 不 
得 不 再 问 一 裔 这 个 问题 。 


对 于 所 提出 的 问题 ， 有 时 候 需要 一 点 时 间 进 行 获 取 或 计算 才能 得 到 答 
和 案 。 我 们 可 能 需要 在 数据 库 中 获取 数据 ， 调 用 远程 服务 或 者 执行 复杂 的 
计算 。 为 了 得 到 答案 ， 这 就 会 花费 时 间 和 资源 。 


如 果 问 题 的 答案 变更 不 那么 频 蚂 (或 者 根本 不 会 发 生变 化 )， 那 么 按照 
相同 的 方式 再 去 获取 一 过 就 是 一 种 浪费 了 。 除 此 之 外 ， 这 样 做 还 可 能 会 
对 应 用 的 性 能 产生 负面 的 影响 。 一 通 又 一 过 地 问 相 同 的 问题 ， 而 每 次 得 
到 的 答案 都 是 一 样 的， 与 其 这 样 ， 我 们 还 不 如 只 问 一 过 并 将 答案 记 住 ， 
以 便 稍 后 再 次 需要 时 使 用 。 


缓存 《Caching) 可 以 存储 经 常会 用 到 的 信息 ， 这 样 每 次 需要 的 时 候 ， 























这 些 信息 都 是 立即 可 用 的 。 在 本 章 中 ， 我 们 将 会 了 解 到 Spring 的 缓存 失 
象 。 尽 管 Spring 自身 并 没有 实现 缓存 解决 方案 ， 但 是 它 对 缓存 功能 提供 
了 声明 式 的 支持 ， 能 够 与 多 种 流行 的 缓存 实现 进行 集成 。 


13.1 启用 对 缓存 的 支持 
Spring 对 绥 存 的 文 持 有 两 种 方式 : 


。 注解 驱动 的 缓存 
。 XML 声明 的 缓存 


使 用 Spring 的 缓存 抽象 时 ， 最 为 通用 的 方式 就 是 在 方法 上 添 

加 @Cacheable 和 @CacheEvict 注 解 。 在 本 章 中 ， 大 多 数 内 容 都 会 使 用 
这 种 类 型 的 声明 式 注 解 。 在 13.3 小 节 中 ， 我 们 会 看 到 如 何 使 用 XML 来 声 
明 绥 存 边 界 。 


在 往 bean 上 添加 缓存 注解 之 前 ， 必 须要 启用 Spring 对 注解 驱动 缓存 的 文 
持 。 如 果 我 们 使 用 Java 配 置 的 话 ， 那 么 可 以 在 其 中 的 一 个 配置 类 上 添 
加 @EnableCaching， 这 样 的 话 就 能 启用 注解 驱动 的 缓存 。 的 13.1 展 现 
了 如 何 实际 使 用 @EnableCaching。 


程序 清单 13.1 通过 使 用 @EnableCaching 启 用 注解 驱动 的 缓存 


package com.habuma.cachefun; 











import org.springframework.cache.CacheManager; 





ework.cache.annotation.EnableCaching; 





Configuration 
GEnablecaching < 启用 缓存 


public class CachingConfig { 


Bean 
public CacheManager cacheManager!() { 4 声明 缓存 管理 器 
return new ConcurrentMapCacheManager () ; 


如 由 以 XML 的 方式 配置 应 用 的 话 ， 那 么 可 以 使 用 Spring cache 命 名 空间 
中 的 <cache:annotation-driven> 元 素来 启用 注解 驱动 的 缓存 。 


程序 清单 13.2 通过 使 用 启用 注解 驱动 的 缓存 


TY 


<?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 


xmins:xsi="http://y 3.0rg/2001/XMLSchema-instance" 





springframework.org/schema/cache" 


xsi:schemal 






http Kk /beans 
http rk.or /beans/spring-beans.xsd 
httr rk.o a/ cache 
httr swork.org/schema/cache/spring-cache.xsd"> 
<cact 2 田 旭 在 
用 用 缓存 
<bean id="cacheManager" class= 
"org.springframework.cache.concurrent .ConcurrentMapCacheManager" /> 
2 2 yat tz Me THH BE 
</beans> 声明 缓存 管理 器 


其 实在 本 质 上 ，@EnableCaching 和 <cache:annotation-driven> 的 
工作 方式 是 相同 的 。 它 们 都 会 创建 一 个 切面 (aspect〉 并 触及 Spring 绥 存 
注解 的 切 点 〈pointcut) 。 根 据 所 使 用 的 注解 以 及 缓存 的 状态 ， 这 个 切 
人 


在 程序 清单 13.1 和 程序 清单 13.2 中 ， 你 可 能 已 经 注意 到 了 ， 它 们 不 仅仅 
局 用 了 注解 驱动 的 缓存 ， 还 声明 了 一 个 缓存 管理 器 (cache manager) 的 
bean。 绥 存 管 理 堪 是 Spring 缓存 抽象 的 核心 ， 它 能 够 与 多 个 流行 的 缓存 
实现 进行 集成 。 


在 本 例 中 ， 声 明了 ConcurrentMapCacheManager， 这 个 简单 的 缓存 管 

理 器 使 用 java.util.concurrent.ConcurrentHashMap 作 为 其 缓存 存 

储 。 它 非常 简单 ， 因 此 对 于 开发 、 测 试 或 基础 的 应 用 来 讲 ， 这 是 一 个 很 

不 错 的 选择 。 但 它 的 缓存 存储 是 基于 内 存 的 ， 所 以 它 的 生命 周期 是 与 应 

0 
兴 。 


幸好 ， 有 多 个 很 棒 的 缓存 管理 器 方案 可 供 使 用 。 让 我 们 看 一 下 几 个 最 为 
和 常用 的 缓存 管理 器 。 


13.1.1 ”配置 缓存 管理 器 
Spring 3.1 内 置 了 五 个 缓存 管理 器 实现 ， 如 下 所 示 : 























。 SimpleCacheManager 
e。 NoopCacheManager 
e ConcurrentMapCacheManager 


。 CompositeCacheManager 
e。 EhCacheCacheManager 


Spring 3.2 引 入 了 另外 一 个 缓存 管理 器 ， 这 个 管理 器 可 以 用 在 基于 
JCache 〈JSR-107) 的 缓存 提 供 商 之 中 。 除 了 核心 的 Spring 框架 ，Spring 
Data 义 提供 了 两 个 缓存 管理 器 : 


。 RedisCacheManager 〈 来 自 于 Spring Data Redis 项 目 ) 
。 GemfireCacheManager (来 自 于 Spring Data GemFire 项 目 ) 


所 以 可 以 看 到 ， 在 为 Spring 的 缓存 抽象 选择 缓存 管理 器 时 ， 我 们 有 很 多 
可 选 方案 。 有 具体 选择 哪 一 个 要 取决 于 想 要 使 用 的 确 层 缓存 供应 商 。 每 一 
个 方案 都 可 以 为 应 用 提供 不 同 风格 的 缓存 ， 其 中 有 一 些 会 比 其 他 的 更 加 
适用 于 生产 环境 。 尺 管 所 做 出 的 选择 会 影响 到 数据 如 何 缓存 ， 但 是 
Spring 声 明 绥 存 的 方式 上 并 没有 什么 差别 。 


我 们 必须 选择 一 个 绥 存 管理 器 ， 然 后 要 在 Spring 应 用 上 下 文中 ， 以 bean 
的 形式 对 其 进行 配置 。 我 们 已 经 看 到 了 如 何 配 

置 ConcurrentMapCacheManager， 并 且 知 道 它 可 能 并 不 是 实际 应 用 的 
最 佳 选 择 。 现 在 ， 看 一 下 如 何 配置 Spring 其 他 的 缓存 管 理 器 ， 从 
EhCacheCacheManager 开 始 吧 。 


使 用 Ehcache 绥 存 


Ehcache 是 最 为 流行 的 缓存 供应 商 之 一 。 Ehcache 网 站 上 说 它 是 “Java 领 域 
应 用 最 为 广泛 的 缓存 ”。 鉴于 它 的 广 泛 采 用 ， Spring 提 供 集成 Ehcache 的 
缓存 管理 器 是 很 有 意义 的 。 这 个 缓存 管理 器 也 就 


是 EhCacheCacheManager。 


当 读 这 个 名 字 的 时 候 ， 在 cache 这 个 词 上 似乎 有 点 结 结巴 巴 的 感觉 。 在 
Spring 中 配置 EhCacheCacheManager 是 很 容易 的 。 程 序 清单 13.3 展 现 了 
如 何在 Java 中 对 其 进行 配置 。 


程序 清单 13.3 ”以 Java 配 置 的 方式 设置 EhCacheCacheManager 

















GEnablecaching 


public class CachingConfig { 配置 


@Bean EhCacheCacheManager 
public EhCacheCacheManager cacheManager (CacheManager cm) { 
return new EhCacheCacheManager (cm); 


EhCacheManagerFactoryBean 





new ClassPathResource("com/habuma/spittr/cache/ehcache.xml")); 
return ehCacheFactoryBean; 
} 
J 


在 程序 清单 13.3 中 ，cacheManager() 方 法 创建 了 一 

个 EhCacheCacheManager 的 实例 ， 这 是 通过 传 入 Ehcache 
CacheManager 实 例 实现 的 。 在 这 里 ， 稍 微 有 点 诡异 的 注入 可 能 会 让 人 
感觉 迷惑 ， 这 是 因为 Spring 和 EhCache 都 定义 了 CacheManager 类 型 。 需 
要 明确 的 是 ，EhCache 的 CacheManager 要 被 注入 到 Spring 的 
EhCacheCacheManager (Spring CacheManager 的 实现 ) 之 中 。 


我 们 需要 使 用 EhCache 的 CacheManager 来 进行 注入 ， 所 以 必须 也 要 声明 
一 个 CacheManager bean。 为 了 对 其 进行 简化 ，Spring 提 供 了 
EhCacheManager-FactoryBean 来 生成 EhCache 的 CacheManager。 方 
法 ehcache( ) 会 创建 并 返回 一 个 EhCacheManagerFactoryBean 实 例 。 
因为 它 是 一 个 工厂 bean (也 就 是 说 ， 它 实现 了 Spring 的 FactoryBean 接 
口 ) ， 所 以 注册 在 Spring 应 用 上 下 文中 的 并 不 

是 EhCacheManagerFactoryBean 的 实例 ， 而 是 CacheManager 的 一 个 
实例 ， 因 此 适合 注入 到 EhCacheCacheManager 之 中 。 


除了 在 Spring 中 配置 的 bean， 还 需要 有 针对 EhCache 的 配置 。EhCache 为 
XML 定义 了 上 自己 的 配置 模式 ， 我 们 需要 在 一 个 XML 文件 中 配置 绥 存 ， 
该 文件 需要 符合 EhCache 所 定义 的 模式 。 在 创建 
EhCacheManagerFactoryBean 的 过 程 中 ， 需 要 告诉 它 EhCache 配 置 文 
件 在 什么 地 方 。 在 这 里 通过 调用 setConfigLocation() 方 法 ， 传 





入 ClassPath-Resource， 用 来 指明 EhCache XML 配置 文件 相对 于 根 类 
路 径 〈classpath) 的 位 置 。 


至 于 ehcache.xml 文 件 的 内 容 ， 不 同 的 应 用 之 间 会 有 所 差别 ， 但 是 至 少 需 
要 声明 一 个 最 小 的 缓存 。 例 如 ， 如 下 的 EhCache 配 置 声 明 一 个 名 

为 spittleCache 的 缓存 ， 它 最 大 的 扒 存 储 为 50MB， 存 活 时 间 为 100 
秒 。 


<ehcache> 
<cache name="spittleCache" 
maxBytesLocalHeap="56m" 


timeToLiveSeconds="1060"> 
</cache> 
</ehcache> 





显然 ， 这 是 一 个 基础 的 EhCache 配 置 。 在 你 的 应 用 之 中 ， 可 能 需要 使 用 
EhCache 所 提供 的 丰富 的 配置 选项 。 参 考 EhCache 的 文档 以 了 解 调 优 
EhCache 配 置 的 细节 ， 地 址 


是 http://ehcache.org/documentation/configuration。 
使 用 Redis 绥 存 


如 果 你 仔细 想 一 下 的 话 ， 绥 存 的 条 目 不 过 是 一 个 键 值 对 (key-value 
pair) ， 其 中 key 描 述 了 产生 value 的 操作 和 参数 。 因 此 ， 很 自然 地 束 会 想 
到 ，Redis 作 为 key-value 存 储 ， 非 常 适 合 于 存储 缓存 。 


Redis 可 以 用 来 为 Spring 绥 存 抽象 机 制 存 储 绥 存 条 目 ，Spring Data Redis 
提供 了 RedisCacheManager， 这 是 CacheManager 的 一 个 实现 。 
RedisCacheManager 会 与 一 个 Redis 服 务 器 协作 ， 并 通过 RedisTemplate 
将 缓存 条 目 存 储 到 Redis 中 。 


为 了 使 用 RedisCacheManager， 我 们 需要 RedisTemplate bean 以 及 
RedisConnectionFactory 实 现 类 (如 JedisConnectionFactory) 的 
一 个 bean。 在 第 12 间 中， 我 们 已 经 看 到 了 这 些 bean 该 如 何 配 置 。 

在 RedisTemplate 就 绪 之 后 ， 配 置 RedisCacheManager 就 是 非常 简单 
的 事情 了 ， 如 程序 清单 13.4 所 示 。 


程序 清单 13.4 配置 将 缓存 条 目 存 储 在 Redis 服 务 器 的 缓存 管理 天 











package com.myapp; 

import org.springframework.cache.CacheManager; 

import org.springframework.cache.annotation.EnableCaching; 

import org.springframework.context .annotation.Bean; 

import org.springframework .data.redis.cache.RedisCacheManager; 

import org.springframework.data.redis.connection.jedis 
.JedisConnectionFactory; 

import org.springframework.data.redis.core.RedisTemplate; 

&Configuration 

@EnableCaching 

public class CachingConfig { 

@Bean 


Public CacheManager cacheManager (RedisTemplate redisTemplate) { 


return new RedisCacheManager (redisTemplate); < 一 Redis 绥 存 管理 
， 
’ i bean 
@Bean 
public JedisConnectionFactory redisConnectionFactory() { < Redis 连接 工厂 
JedisConnectionFactory jedisConnectionFactory = bean 
new JedisConnectionFactory(); 
jedisConnectionFactory.afterPropertiessSet{(); 
return jedisConnectionFactory; 
} 
GBean 
public RedisTemplate<String, String> redisTemplate! RedisTemplate 
RedisConnectionFactory redisCF) { bean 


RedisTemplate<String, String> redisTemplate = 
new RedisTemplate<String, String>{(); 

redisTemplate.setConnectionFactory (reQisCF) ; 

redisTemplate.afterPropertiesSet(); 

return redisTemplate:; 


可 以 看 到 ， 我 们 构建 了 一 个 RedisCacheManager， 这 是 通过 传递 一 
个 RedisTemplate 实 例 作 为 其 构造 器 的 参数 实现 的 。 

使 用 多 个 缓存 管理 器 

我 们 并 不 是 只 能 有 且 仅 有 一 个 缓存 管理 器 。 如 果 你 很 难 确定 该 使 用 哪个 


缓存 管理 器 ， 或 者 有 合法 的 技术 理由 使 用 超过 一 个 缓存 管理 器 的 话 ， 那 
么 可 以 尝试 使 用 Spring 的 CompositeCacheManager。 














CompositeCacheManager 要 通过 一 个 或 更 多 的 缓存 管理 器 来 进行 配 
置 ， 它 会 碗 代 这 些 缓存 管理 器 ， 以 查找 之 前 所 缓存 的 值 。 以 下 的 程序 清 
单 展现 了 如 何 创建 CompositeCacheManager bean， 它 会 迭代 
JCacheCacheManager、EhCacheCache-Manager 和 
RedisCacheManager。 





程序 清单 13.5” CompositeCacheManager 会 迭代 一 个 缓存 管理 器 的 列表 


@Bean 
public CacheManager cacheManager( 
net.sf.ehcache.CacheManager cm, 创建 
javax.cache.CacheManager jcm) { CompositeCacheManager 
CompositeCacheManager cacheManager new CompositeCacheManager(}); 
List<CacheManager> managers = new ArrayList<CacheManager> () ; 


managers.add(new JCacheCacheManager (jcm) ) ; 

managers.add (new EhCacheCacheManager {cm)) 
L ( g ) we 人 

添加 单个 

组 在 答 得 照 

缓存 管理 器 


managers.add(new RedisCacheManager (redisTemplate())); 
cacheManager .setCacheManagers (managers); 
return cacheManager; 


} 


当 碍 找 绥 存 条 目 时 ，CompositeCacheManager 首 先 会 从 
JCacheCacheManager 开 始 检查 JCache 实 现 ， 然 后 通过 
EhCacheCacheManager 检 查 Ehcache， 最 后 会 使 用 RedisCacheManager 
来 检查 Redis， 完 成 缓存 条 目的 查找 。 


在 配置 完 缓存 管理 器 并 局 用 缓存 后 ， 就 可 以 在 bean 方 法 上 应 用 缓存 规则 
了 。 让 我 们 看 一 下 如 何 使 用 Spring 的 绥 存 注解 来 定义 缓存 边界 。 

















13.2 ”为 方法 添加 注解 以 文 持 缓存 

如 前 文 所 述 ，Spring 的 缓存 抽象 在 很 大 程度 上 是 围绕 切面 构建 的 。 在 
Spring 中 启用 缓存 时 ， 会 创建 一 个 切面 ， 它 触发 一 个 或 更 多 的 Spring 的 
缓存 注解 。 表 13.1 列 出 了 Spring 所 提供 的 缓存 注解 。 


表 13.1 中 的 所 有 注解 都 能 运用 在 方法 或 类 上 。 当 将 其 放 在 单个 方法 上 








时 ， 注 解 所 描述 的 缓存 行为 只 会 运用 到 这 个 方法 上 。 如 果 注 解放 在 类 级 
别 的 话 ， 那 么 缓存 行为 就 会 应 用 到 这 个 类 的 所 有 方法 上 。 














表 13.1 Spring 提供 了 四 个 注解 来 声明 缓存 规则 




















表明 Spring 在 调用 方法 之 前 ， 首 先 应 该 在 缓存 中 碍 找 方法 的 返回 值 。 如 
@cacheable | 果 这 个 值 能 够 找到 ， 就 会 返回 缓存 的 值 。 否 则 的 话 ， 这 个 方法 就 会 被 调 
用 ， 返 回 值 会 放 到 缓存 之 


人 表明 Spring 应 该 将 方法 的 返回 
查 缓存 ， 方 法 始终 都 会 被 调 

表明 Spring 应 该 在 缓存 中 清除 一 个 或 多 个 条 目 

这 是 一 个 分 组 的 注解 ， 能 够 同时 应 用 多 个 其 他 的 缓存 注解 


13.2.1 填充 缓存 


我 们 可 以 看 到 ，@Cacheable 和 @CachePut 注 解 都 可 以 填充 缓存 ， 但 是 
它们 的 工作 方式 略 有 差异 。 


@Cacheable 首 先 在 缓存 中 但 找 条 目 ， 如 果 找 到 了 匹配 的 条 目 ， 那 么 就 
不 会 对 方法 进行 调用 了 。 如 果 没 有 找到 匹配 的 条 目 ， 方 法 会 被 调用 并 且 
返回 值 要 放 到 缓存 之 中 。 而 @CachePut 并 不 会 在 缓存 中 检查 匹配 的 值 ， 
目标 方法 总 是 会 被 调用 ， 并 将 返回 值 添加 到 缓存 之 中 。 
























































@Cacheable 和 @CachePut 有 一 些 属性 是 共有 的 ， 参 见 表 13.2。 





表 13.2 @Ccacheable 和 @cCachePut 有 一 些 共有 的 属性 


要 人 用 的 分 各 











ui | strina | SpEL 表 达 式 ， 如 果 得 到 的 值 是 false 的 话 ， 不 会 将 缓存 应 用 到 方 
8 | 法 调用 上 
SpEL 表 达 式 ， 用 来 计算 自 定 义 的 缓存 key 


p51 夫 式 ， 加 果 得 到 的 jeme 丘 返回 人 不信 到达 


在 最 简单 的 情况 下 ， 在 @Cacheable 和 @CachePut 的 这 些 属性 中 ， 只 需 

使 用 value 属 性 指定 一 个 或 多 个 缓存 即 可 。 例 如 ， 考 

虑 SpittleRepository 的 findone() 方 法 。 在 初始 保存 之 后 ，Spittle 
就 不 会 再 发 生变 化 了 。 如 采 有 的 Spittle 比 较 热 门 并 且 会 被 频繁 请 求 ， 

反复 地 在 数据 库 中 进行 获取 是 对 时 间 和 资源 的 浪费 。 通 过 在 findone() 
方法 上 添加 @Cacheable 注 解 ， 如 下 面 的 程序 清单 所 示 ， 能 够 确保 

将 Spittle 保 存在 绥 存 中 ， 从 而 避免 对 数据 库 的 不 必要 访问 。 


程序 清单 13.6 ”通过 使 用 @Cacheable， 在 缓存 中 存储 和 获取 值 


@Cacheable("spittleCache'") - 缓存 这 个 方法 的 结果 
public Spittle findone (long idQ) 1{ 
try 1 
return jdbcTemplate.queryForObject ( 


























当 findone() 被 调用 时 ， 绥 存 切 面 会 拦截 调用 并 在 缓存 中 得 找 之 前 以 


名 spittleCache 存 储 的 返回 值 。 缓 存 的 key 是 传递 到 findone() 方 法 中 
的 id 参数 。 如 果 按 照 这 个 key 能 够 找到 值 的 话 ， 束 会 返回 找到 的 值 ， 方 
法 不 会 再 被 调用 。 如 果 没 有 找到 值 的 话 ， 那 么 就 会 调用 这 个 方法 ， 并 将 
返回 值 放 到 缓存 之 中 ， 为 下 一 次 调用 findone() 方 法 做 好 准备 。 


在 程序 清单 13.6 中 ，@Cacheable 注 解 被 放 到 了 
JdbcSpittleRepository 的 findone() 方 法 实现 上 。 这 样 能 够 起 作 
用 ， 但 是 缓存 的 作用 只 限于 JdbcSpittleRepository 这 个 实现 类 
中 ，SpittleRepository 的 其 他 实现 并 没有 绥 存 功能 ， 除 非 也 为 其 添 
加 上 @Cacheable 注 解 。 因 此 ， 可 以 考虑 将 注解 添加 

到 spittleRepository 的 方法 声明 上 ， 而 不 是 放 在 实现 类 中 : 


@Cacheable("spittleCache") 

Spittle findone(long id); 

当 为 接口 方法 添加 注解 后 ，@Cacheable 注 解 会 被 SpittleRepository 
的 所 有 实现 继承 ， 这 些 实现 类 都 会 应 用 相同 的 缓存 规则 。 


将 值 放 到 缓存 之 中 


@Cacheable 会 条 件 性 地 触发 对 方法 的 调用 ， 这 取决 于 缓存 中 是 不 是 已 
经 有 了 所 需要 的 值 ， 对 于 所 注解 的 方法 ，@CachePut 采 用 了 一 种 更 为 直 
接 的 流程 。 带 有 @CachePut 注 解 的 方法 始终 都 会 被 调用 ， 而 且 它 的 返回 
值 也 会 放 到 缓存 中 。 这 提供 一 种 很 便利 的 机 制 ， 能 够 让 我 们 在 请 求 之 前 
预先 加 载 缓存 。 


例如 ， 当 一 个 全 新 的 Spittle 通 过 spittleRepository 的 save() 方 法 
保存 之 后 ， 很 可 能 马上 束 会 请 求 这 条 记录 。 所 以 ， 当 save( ) 方 法 调用 
后 ， 立 即将 spittle 塞 到 缓存 之 中 是 很 有 意义 的 ， 这 样 当 其 他 人 通过 
findone() 对 其 进行 查找 时 ， 它 就 已 经 准备 就 绪 了 。 为 了 实现 这 一 点 ， 
可 以 在 save() 方 法 上 添加 @CachePut 注 解 ， 如 下 所 示 : 


@Cacheput("spittleCache") 

Spittle save(Spittle spittle); 

当 save( ) 方 法 被 调用 时 ， 它 首先 会 做 所 有 必要 的 事情 来 保存 Spittle， 
然后 返回 的 Spittle 会 被 放 到 spittleCache 绥 存 中 。 





























在 这 里 只 有 一 个 问题 : 缓存 的 key。 如 前 文 所 述 ， 默 认 的 缓存 key 要 基于 
方法 的 参数 来 确定 。 因 为 save() 方 法 的 唯一 参数 就 是 spittle， 所 以 它 
会 用 作 绥 存 的 key。 将 Spittle 放 在 缓存 中 ， 而 它 的 缓存 key 恰 好 是 同一 
个 spittle， 这 是 不 是 有 一 点 诡异 呢 ? 


显然 ， 在 这 个 场景 中 ， 默 认 的 缓存 key 并 不 是 我 们 想 要 的 。 我 们 需要 的 
缓存 key 是 新 保存 Spittle 的 ID， 而 不 是 Spittle 本 喘 。 所 以 ， 在 这 里 需 
要 指定 一 个 key 而 不 是 使 用 默认 的 key。 让 我 们 看 一 下 怎样 自 定 义 缓存 
key。 





自 定 义 缓存 key 


Q@Cacheable 和 @CachePut 都 有 一 个 名 为 key 必 性， 这 个 属性 能 够 蔡 换 默 
认 的 key， 它 是 通过 一 个 SpEL 表 达 式 计算 得 到 的 。 任 意 的 SpEL 表 达 式 都 
是 可 行 的 ， 但 是 更 常见 的 场景 是 所 定义 的 表达 式 与 存储 在 缓存 中 的 值 有 
关 ， 据 此 计算 得 到 key。 


具体 到 我 们 这 个 场景 ， 我 们 需要 将 key 设 置 为 所 保存 Spittle 的 ID。 以 
参数 形式 传递 给 save() 的 Spittle 还 没有 保存 ， 因 此 并 没有 ID。 我 们 只 
能 通过 save( ) 人 返回 的 Spittle 得 到 id 属 性 。 


填 好 ， 在 为 缓存 编写 SpEL 表 达 式 的 时 候 ，Spring 暴 露 了 一 些 很 有 用 的 元 
数据 。 表 13.3 列 出 了 SpEL 中 可 用 的 缓存 元 数据 。 











表 13.3” ”Spring 提供 了 多 个 用 来 定义 缓存 规则 的 SpEL 扩 展 























#root.args 传递 给 缓存 方法 的 参数 ， 形 式 为 数组 


该 方法 执行 时 所 对 应 的 缓存 ， 形 式 为 数组 
目标 对 象 的 类 ， 是 #root.target.class 的 简写 形式 





#root.method 缓存 方法 





#root.methodName 缓存 方法 的 多 全 y 是 #root .method .name 的 简 写 形 式 

















方法 调用 的 返回 值 〈 不 能 用 在 ecacheable 注 解 上 ) 











#Argument 任意 的 方法 参数 名 (如 #argName ) 或 参数 索引 〈 如 #ae 或 #p6) 





对 于 save() 方 法 来 说 ， 我 们 需要 的 键 是 所 返回 Spittle 对 象 的 1d 属 
性 。 表 达 式 #result 能 够 得 到 返回 的 Spittle。 借 助 这 个 对 象 ， 我 们 可 
以 通过 将 key 属 性 设置 为 #result .id 来 引用 id 属性 : 


@CachePut(value="spittleCache", key="#result.id") 


Spittle save(Spittle spittle); 








按照 这 种 方式 配置 @CachePut， 绥 存 不 会 去 干涉 save() 方 法 的 执行 ， 但 
A 并 且 缓 存 的 key 与 Spittle 的 id 
属性 相同 。 


条 件 化 缓存 


通过 为 方法 添加 Spring 的 绥 存 注解 ，Spring 束 会 围绕 着 这 个 方法 创建 一 
个 缓存 切面 。 但 是 ， 在 有 些 场景 下 我 们 可 能 希望 将 缓存 功能 关闭 。 


Q@Cacheab1le 和 @CachePut 提 供 了 两 个 属性 用 以 实现 条 件 化 组 

存 : Unless 和 condition， 这 两 个 属性 都 接受 一 个 SpEL 表 达 式 。 如 果 
unless 属 性 的 SpEL 表 达 式 计算 结果 为 true， 那 么 缓存 方法 返回 的 数据 
就 不 会 放 到 缓存 中 。 与 之 类 似 ， 如 果 condition 属 性 的 SpEL 表 达 式 计 
算 结 果 为 false， 那 么 对 于 这 个 方法 绥 存 就 会 被 禁用 掉 。 


表面 上 来 看 ，unless 和 condition 属 性 做 的 是 相同 的 事情 。 但 是 ， 这 

里 有 一 点 细微 的 差别 。unless 属 性 只 能 阻止 将 对 象 放 进 缓存 ， 但 是 在 

这 个 方法 调用 的 时 候 ， 依 然 会 去 缓存 中 进行 查找 ， 如 果 找 到 了 匹配 的 

值 ， 就 会 返回 找到 的 值 。 与 之 不 同 ， 如 果 condition 的 表达 式 计 算 结果 
为 false， 那 么 在 这 个 方法 调用 的 过 程 中 ， 缓 存 是 被 茶 用 的 。 就 是 说 ， 

不 会 去 缓存 进行 查找 ， 同 时 返回 值 也 不 会 放 进 缓存 中 。 











作为 样 例 〈 尽 管 有 些 牵 强 ) ， 假 设 对 于 message 属 性 包含 “NoCache” 的 
Spittle 对 象 ， 我 们 不 想 对 其 进行 缓存 。 为 了 阻止 这 样 的 Spittle 对 象 
被 缓存 起 来 ， 可 以 这 样 设 置 unless 属 性 : 


@Cacheable(value="spittleCache" 


unless="#result.message.contains('NoCache')") 
Spittle findone(1long id); 





为 unless 设 置 的 SpEL 表 达 式 会 检查 返回 的 Spittle 对 象 ( 在 表达 式 中 
通过 #result 来 识别 ) 的 message 属 性 。 如 果 它 包含 “NoCache” 文 本 内 
， 那 么 这 个 表达 式 的 计算 值 为 true， 这 个 Spittle 对 象 不 会 放 进 缓存 
否则 的 话 ， 表 达 式 的 计算 结果 为 false， 无 法 满足 unless 的 条 件 ， 
这 个 Spittle 对 象 会 被 缓存 。 


属性 unless 能 够 阻止 将 值 写 入 到 缓存 中 ， 但 是 有 时 候 我 们 和 希望 将 缓存 
全 部 禁用 。 也 就 是 说 ， 在 一 定 的 条 件 下 ， 我 们 既 不 希望 将 值 添加 到 缓存 
中 ， 也 不 希望 从 绥 存 中 获取 数据 。 


例如 ， 对 于 ID 值 小 于 10 的 Spittle 对 象 ， 我 们 不 希望 对 其 使 用 组 在。 在 
这 种 场景 下 ， 这 些 spittle 是 用 来 进行 调试 的 测试 条 有 目 ， 对 其 进行 缓存 
并 没有 实际 的 价值 。 为 了 要 对 ID 小 于 10 的 Spitt1le 关 闭 缓存 ， 可 以 

在 @Cacheable 上 使 用 condition 属 性 ， 如 下 所 示 : 





@Cacheable(value="spittleCache" 


unless="#result.message.contains('NoCache')" 
condition="#id >= 16") 
Spittle findone(1long id); 





如 果 findone() 调 用 时 ， 参 数值 小 于 10， 那 么 将 不 会 在 缓存 中 进行 查 
找 ， 返 回 的 Spitt1le 也 不 会 放 进 缓存 中 ， 就 像 这 个 方法 没有 添 
加 @Cacheable 注 解 一 样 。 


如 样 例 所 示 ，unless 属 性 的 表达 式 能 够 通过 #result 引 用 返回 值 。 这 是 
很 有 用 的 ， 这 么 做 之 所 以 可 行 是 因为 unless 属 性 只 有 在 缓存 方法 有 返 
回 值 时 才 开 始 发 挥 作 用 。 而 condition 肩 负 着 在 方法 上 禁用 绥 存 的 任 
务 ， 因 此 它 不 能 等 到 方法 返回 时 再 确定 是 侣 该 天 闭 组 存 。 这 意味 着 它 的 
0 要 在 进入 方法 时 进行 计算 ， 所 以 我 们 不 能 通过 #result 引 用 
返回 值 。 








我 们 现在 已 经 在 缓存 中 添加 了 内 容 ， 但 是 这 些 内 容 能 被 移 除 反 吗 ? 接 下 
来 看 一 下 如 何 借助 @CcacheEvict 将 缓存 数据 移 除 掉 。 


13.2.2 移 除 缓存 条 日 


@CacheEvict 并 不 会 往 缓存 中 添加 任何 东西 。 相 反 ， 如 果 市 
有 @CacheEvict 注 解 的 方法 被 调用 的 话 ， 那 么 会 有 一 个 或 更 多 的 条 目 会 
在 缓存 中 移 除 。 


那么 在 什么 场景 下 需要 从 缓存 中 移 除 内 容 呢 ? 当 组 存 值 不 再 合法 时 ， 我 
们 应 该 确保 将 其 从 绥 存 中 移 除 ， 这 样 的 话 ， 后 续 的 缓存 命中 就 不 会 返回 
上 日 的 或 者 已 经 不 存在 的 值 ， 其 中 一 个 这 样 的 场景 就 是 数据 被 删除 掉 了 。 
这 样 的 话 ，SpittleRepository 的 remove( ) 方 法 就 是 使 

用 @CacheEvict 的 绝 佳 选择 : 


@CacheEvict("spittleCache") 
void remove(long spittleld); 
王 玩 对 与 6cacheable 和 6cacheput 不 同 ，9CacheEvict 能 够 应 用 在 返回 值 为 void 的 方法 
上 ， 而 @Cacheable 和 @CachePut 需 要 非 void 的 返回 值 ， 它 将 会 作为 放 在 缓存 中 的 条 目 。 
为 @CacheEvict 只 是 将 条 目 从 缓存 中 移 除 ， 因 此 它 可 以 放 在 任意 的 方法 上 ， 甚 至 void 方 法 。 


从 这 里 可 以 看 到 ， 当 remove( ) 调 用 时 ， 会 从 绥 人 存 中 删除 一 个 条 目 。 被 
删除 条 目的 key 与 传递 进来 的 spittleId 参 数 的 值 相 等 。 


@CacheEvict 有 多 个 属性 ， 如 表 13.4 所 示 ， 这 些 属性 会 影响 到 该 注解 的 
行为 ， 使 其 不 同 于 默认 的 做 法 。 


可 以 看 到 ，@CacheEvict 的 一 些 属性 与 @Cacheab1e 和 @CachePut 是 相 
同 的 ， 另 外 还 有 几 个 新 的 属性 。 与 @Cacheable 和 Q@CachepPut 不 
同 ，Q@CacheEvict 并 没有 提供 unless 属 性 。 


Spring 的 缓存 注解 提供 了 一 种 优雅 的 方式 在 应 用 程序 的 代码 中 声明 缓存 
规则 。 但 是 ，Spring 还 为 缓存 提供 了 XML 命名 空间 。 在 结束 对 绥 存 的 讨 
论 之 前 ， 我 们 快速 地 看 一 下 如 何以 XML 的 形式 配置 缓存 规则 。 


表 13.4 @CacheEvict 注 解 的 属性 ， 指 定 了 哪些 缓存 条 目 应 该 被 移 除 掉 
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性 型 描 述 


要 使 用 的 缓存 名 称 
SpEL 表 达 式 ， 用 来 计算 自 定义 的 缓存 key 


如 果 得 到 的 值 是 false 的 话 ， 组 存 不 会 应 用 到 
方法 调 


入 








e 


valu 






































如 果 为 true 的 话 ， 特 定 缓 存 的 所 有 条 目 都 会 被 移 除 挥 
b 


beforeInvocation 如 果 为 true 的 话 ， 在 方法 调用 之 前 移 除 条 目 。 如 k 
oolean | 为 false《〈 默 认 值 ) 的 话 ， 在 方法 成 功 调用 之 后 再 









































13.3 ”使 用 XML 声明 缓存 


你 可 能 想 要 知道 为 什么 想 要 以 XML 的 方式 声明 缓存 。 毕 竟 ， 本 章 中 我 
们 所 看 到 的 缓存 注解 要 优雅 得 多 。 


我 认为 有 两 个 原因 : 


。 你 可 能 会 觉得 在 自己 的 源码 中 添加 Spring 的 注解 有 点 不 太 舒 服 ; 
。 你 需要 在 没有 源码 的 bean 上 应 用 缓存 功能 。 


在 上 面 的 任意 一 种 情况 下 ， 最 好 (或 者 说 需要 ) 将 缓存 配置 与 缓存 数据 
的 代码 分 隔 开 来 。Spring 的 cache 命 名 空间 提供 了 使 用 XML 声明 缓存 规 
则 的 方法 ， 可 以 作为 面向 注解 缓存 的 替代 方案 。 因 为 缓存 是 一 种 面向 切 
面 的 行为 ， 所 以 cache 命 名 空间 会 与 Spring 的 aop 命 名 空间 结合 起 来 使 
用 ， 用 来 声明 缓存 所 应 用 的 切 点 在 哪里 。 


要 开始 配置 XML 声明 的 组 在， 首先 需要 创建 Spring 配置 文件 ， 这 个 文件 


中 要 包含 cache 和 aop 命 名 空间 : 











<?xml version="1.6” encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xmlns:cache="http://www.springframework.org/schema/cache" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/aop 
http://www.springframework.org/schema/aop/spring-aop.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd 
http://www.springframework.org/schema/cache 
http://www.springframework.org/schema/cache/spring-cache.xsd"> 


<!-- Caching configuration will go here --> 


</beans> 








cache 命 名 空间 定义 了 在 Spring XML 配置 文件 中 声明 缓存 的 配置 元 素 。 
表 13.5 列 出 了 cache 命 名 空间 所 提供 的 所 有 元 素 。 


表 13.5 ”Spring 的 cache 命 名 空间 提供 了 以 XML 方式 配置 缓存 规则 的 元 素 


















































注解 驱动 的 缓存 。 等 同 于 Java 配 置 中 的 @EnableCcaching 


0 前 知 (advice) 。 结 合 <aop:advisor>， 将 通知 应 用 到 切 


<cache:advice> 


在 缓存 通知 中 ， 定 义 一 组 特定 的 缓存 规则 








个 方法 要 进行 明 丰 等同 Ecaeheableiz 角 


利明 车 个 方法 要 填充 缓存 ， 但 不 会 考虑 缓存 中 是 否 已 有 匹配 的 
。 等同 于 @cachePut 注 解 











<cache:cache-put> 值 











<cache:cache- 指明 某 个 方法 要 从 缓存 中 移 除 一 个 或 多 个 条 目 ， 等 同 于 


evict> @cacheEvict 注 解 





<cache:annotation-driven> 元 素 与 Java 配 置 中 所 对 应 的 
@EnableCaching 非 常 类 似 ， 会 启用 注解 驱动 的 缓存 。 我 们 已 经 讨论 过 
这 种 风格 的 缓存 ， 因 此 没有 必要 再 对 其 进行 介绍 。 

表 13.5 中 其 他 的 元 素 都 用 于 基于 XML 的 缓存 配置 。 接 下 来 的 代码 清单 展 
现 了 如 何 使 用 这 些 元 素 为 SpittleRepositorybean 配 置 缓存 ， 其 作用 
等 同 于 本 章 前 面 章 使 用 缓存 注解 的 方式 。 


程序 清单 13.7 ”使 用 XML 元 素 为 SpittleRepository 声 明 缓存 规则 





<?xml] version=" 


0 


encoding="UTF-8"?> 


<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0rg/2001/XMLSchema-instance" 
xmlns:cache="http://www.springframework.org/schema/cache" 
xmlns:aop="http://www.springframework.org/schema/aop" 
xsi:schemaLocation="http://www.springframework.org/schema/aop 


http://www. 
http://www. 
http://Wwww. 
http: / /www. 
http://www. 


<aop:config> 


springframework. 
springframework. 
springframework. 
springframework. 
springframework. 


org/schema/aop/spring-aop.xsd 
org/schema/beans 
org/schema/beans/spring-beans .xsd 
org/schema/cache 
org/schema/cache/spring-cache.xsd"> 


将 缓存 通知 绑 定 


<aop:advisor advice-ref="cacheAdvice" 到 一 个 切 点 上 
pointcut= WR 
"execution{(* com.habuma.spittr.db.SpittleRepository.*{(..)}"/> 


</aop:config> 


<cache:advice id="cacheAdvice'"> 
<cache:caching> 
<cache:cacheable 
cache="spittleCache" 
method="findRecent" 


<cache:cacheable 


cache="spittleCache" 


<cache:cacheable 


cache="spittleCache" 


/> 


method="findone" /> 


< 一 配置 为 支持 缓存 


method="findBySpitterId" /> 


<cache:cache-put 


cache="spittleCache" 


method="save" 


key= 


"#result.id" /> 


<cache:cache-evict 


cache="spittleCache" 


method="remove" /> 


</cache:caching> 
</cache:advice> 


<bean id="cacheManager" 


< 一 在 save 时 填充 缓存 


从 缓存 中 移 除 


class= 


"org.springframework.cache.concurrent.ConcurrentMapCacheManager" 


/> 


</beans> 


在 程序 清单 13.7 中 ， 我 们 首先 看 到 的 是 <aop:advisor>， 它 引用 ID 
为 cacheAdvice 的 通知 ， 该 元 素 将 这 个 通知 与 一 个 切 点 进行 匹配 ， 因 此 
建立 了 一 个 完整 的 切面 。 在 本 例 中 ， 这 个 切面 的 切 点 会 在 执 

行 SpittleRepository 的 任意 方法 时 触发 。 如 果 这 样 的 方法 被 Spring 应 
用 上 下 文中 的 任意 某 个 bean 所 调用 ， 那 么 就 会 调用 切面 的 通知 。 





在 这 里 ， 通 知 利用 <cache:advice> 元 素 进行 了 声明 。 


在 <cache:advice> 元 素 中 ， 可 以 包含 任意 数量 的 <cache:caching> 元 





素 ， 这 些 元 系 用 来 完整 地 定义 应 用 的 缓存 规则 。 在 本 例 中 ， 


个 <cache:caching> 元 素 。 这 个 元 素 又 包含 了 三 个 


只 包含 了 一 


<cache:cacheable> 元 素 和 一 个 <cache :cache-put> 元 素 。 


每 个 ccache:cacheable> 元 系 都 声明 了 切 点 中 的 茶 一 个 方法 是 文 持 绥 
存 的 。 这 是 与 @Cacheable 注 解 同等 作用 的 XML 元 素 。 具 体 来 

讲 ，findRecent()、findone() 和 findBySpitterId() 都 声明 为 文 持 
缓存 ， 它 们 的 返回 值 将 会 保存 在 名 为 spittlecache 的 缓存 之 中 。 


<cache:cache-put> 是 Spring XML 中 与 @CachePut 注 解 同等 作用 的 元 
素 。 它 表明 一 个 方法 的 返回 值 要 填充 到 缓存 之 中 ， 但 是 这 个 方法 本 里 并 
不 会 从 缓存 中 获取 返回 值 。 在 本 例 中 ，save( ) 方 法 用 来 填充 缓存 。 同 
人 我 们 需要 将 默认 的 key 改 为 返回 spittle 对 象 的 
id 属 性 。 


最 后 ，<cache:cache-evict> 元 素 是 Spring XML 中 用 来 替代 
@CacheEvict 注 解 的 。 它 会 从 缓存 中 移 除 元 素 ， 这 样 的 话 ， 下 次 有 人 进 
行 查找 的 时 候 就 找 不 到 了 。 在 这 里 ， 调 用 remove( ) 时 ， 会 将 缓存 中 的 
Spitt1le 删 除 掉 ， 其 中 key 与 remove() 方 法 所 传递 进来 的 ID 参数 相等 的 
条 目 会 从 缓存 中 移 除 。 


需要 注意 的 是 ，<cache:advice> 元 素 有 一 个 cache-manager 元 素 ， 用 
来 指定 作为 缓存 管理 器 的 bean。 它 的 默认 值 是 cacheManager， 这 与 程 
序 清 单 13.7 底 部 的 <bean> 声 明 恰 好 是 一 致 的 ， 所 以 没有 必要 再 显 式 地 进 
行 设 置 。 但 是 ， 如 果 绥 存 管 理 器 的 ID 与 之 不 同 的 话 〈 使 用 多 个 缓存 管理 
器 的 时 候 ， 可 能 会 遇 到 这 样 的 场景 ) ， 那 么 可 以 通过 设置 cache- 
manager 属 性 指定 要 使 用 哪个 绥 存 管理 器 。 

















另外 ， 还 要 留意 的 是 ，<cache:cacheable>、<cache:cache-put> 和 
<cache:cache-evict> 元 素 都 引用 了 同一 个 名 为 spittleCcache 的 组 
存 。 为 了 消除 这 种 重复 ， 我 们 可 以 在 <cache:caching> 元 素 上 指明 组 
存 的 名 字 : 








<cache:advice id="cacheAdvice"> 
<cache:caching cache="spittleCache"> 


<cache:cacheable method="findRecent" /> 
<cache:cacheable method="findone” /> 


<cache:cacheable method="findBySpitterId" /> 


“cache :cache-put 
method="save" 
key="#result.id" /> 


<cache:cache-evict method="remove" /> 


</cache:caching> 
</cache:advice> 





<cache:caching> 有 几 个 可 以 供 
<cache:cacheable>、<cache:cache-put> 和 <cache:cache-evict> 


共享 的 属性 ， 包 括 : 
cache: 指明 要 存储 和 获取 值 的 缓存 ; 


condition: SpEL 表 达 式 ， 如 下 计算 得 到 的 值 为 false， 将 会 为 这 个 方 
法 禁用 缓存; 


key: SpEL 表 达 式 ， 用 来 得 到 缓存 的 key《〈 默 认为 方法 的 参数 ) ; 
method: 要 缓存 的 方法 名 。 


除 此 之 外 ，xcache:cacheable> 和 <cache:cache-put> 还 有 一 
个 unless 必 性， 可 以 为 这 个 可 选 的 属性 指定 一 个 SpEL 表 达 式 ， 如 果 这 
个 表达 式 的 计算 结果 为 true， 那 么 将 会 阻止 将 返回 值 放 到 绥 存 之 中 。 


<cache:cache-evict> 元 素 还 有 几 个 特有 的 属性 : 


e。 al1-entries: 如 果 是 true 的 话 ， 组 存 中 所 有 的 条 目 都 会 被 移 除 
挤 。 如 果 是 false 的 话 ， 只 有 匹配 key 的 条 目 才 会 被 移 除 掉 。 

。before-invocation: 如 果 是 true 的 话 ， 绥 存 条 目 将 会 在 方法 调 
人 如 果 是 false 的 话 ， 方 法 调用 之 后 才 会 移 除 组 
子 。 


all-entries 和 before-invocation 的 默认 值 都 是 false。 这 意味 着 在 
使 用 <cache:cache-evict> 元 素 日 不 配置 这 两 个 属性 时 ， 会 在 方法 调 
用 完成 后 只 删除 一 个 缓存 条 目 。 要 删除 的 条 目 会 通过 默认 的 key (基于 
方法 的 参数 ) 进行 识别 ， 当 然 也 可 以 通过 为 名 为 key 的 属性 设置 一 个 
SpEL 表 达 式 指定 要 删除 的 key。 





13.4 小结 


如 果 想 让 应 用 程序 避免 一 过 遇 地 为 同一 个 问题 推导 、 计 算 或 得 询 答案 的 
话 ， 绥 存 是 一 种 很 棒 的 方式 。 当 以 一 组 参数 第 一 次 调用 某 个 方法 时 ， 返 
回 值 会 被 保存 在 缓存 中 ， 如 果 这 个 方法 再 次 以 相同 的 参数 进行 调用 时 ， 
这 个 返回 值 会 从 缓存 中 查询 获取 。 在 很 多 场景 中 ， 从 缓存 查找 值 会 比 其 
他 的 方式 〈 比 如 ， 执 行 数据 库 查 询 ) 成 本 更 低 。 因 此 ， 绥 存 会 对 应 用 程 
序 的 性 能 带 来 正面 的 影 啊 。 


在 本 章 中 ， 我 们 看 到 了 如 何在 Spring 应 用 中 声明 缓存 。 首 先 ， 看 到 的 是 
如 何 声明 一 个 或 更 多 的 Spring 绥 存 管理 器 。 然 后 ， 将 缓存 用 到 了 Spittr 
应 用 程序 中 ， 这 是 通过 将 @Cacheable、@CachePut 和 @CacheEvict 添 
加 到 SpittleRepository 上 实现 的 。 


我 们 还 看 到 了 如 何 借助 XML 将 绥 存 规则 的 配置 与 应 用 程序 代码 分 离开 
来 。<xcache:cacheable>、<cache:cache-put> 和 <cache:cache- 


evict> 元 素 的 作用 与 本 章 前 面 所 使 用 的 注解 是 一 致 的 。 


在 这 个 过 程 中 ， 我 们 讨论 了 缓存 实 际 上 是 一 种 面 问 切面 的 行为 。Spring 
将 缓存 实现 为 一 个 切面 。 在 使 用 XML 声明 缓存 规则 时 ， 这 一 点 非常 明 
显 : 我 们 必须 要 将 缓存 通知 绑 定 到 一 个 切 点 上 。 


Spring 在 将 安全 功能 应 用 到 方法 上 时 ， 同 样 使 用 了 切面 。 在 下 一 章 中 ， 
我 们 将 会 看 到 如 何 借助 Spring Security 确 保 bean 方 法 的 安全 性 。 























第 14 半 ”保护 方法 应 用 
本 章 内 容 : 


。 保护 方法 调用 
。 使 用 表达 式 定义 安全 规则 
。 创建 安全 表达 式 计算 器 


在 离 家 或 上 床 睡 觉 之 前 ， 我 做 的 最 后 一 件 事 就 是 确保 房间 的 门 已 经 关 
好 。 但 是 在 此 之 前 ， 我 会 设置 好 警报 。 为 什么 呢 ? 这 是 因为 ， 尽 管 门 锁 
是 保证 安全 的 一 个 好 办 法 ， 但 是 警报 系统 提供 了 第 二 层 防 护 ， 急 贼 有 可 
能 会 越过 门 锁 的 保护 。 


在 第 9 章 中 ， 我 们 看 到 了 如 何 使 用 Spring Security 保 护 应 用 的 Web 层 。 
Web 安 全 是 非常 重要 的 ， 它 能 阻止 用 户 访 问 没 有 权限 的 内 容 。 但 是 ， 如 
果 应 用 的 Web 层 出 现 安全 漏洞 会 怎样 呢 ? 如 果 用 户 能 够 请 求 他 们 不 允许 
访问 的 内 容 会 怎样 呢 ? 


尽管 我 们 没有 理由 认为 用 户 能 够 攻破 应 用 的 安全 层 ， 但 是 在 Web 层 出 现 
安全 漏洞 实在 是 太 容易 了 。 例 如 ,假设 用 户 请 求 了 一 个 允许 访问 的 页 

面 ， 但 是 由 于 开发 人 员 不 认真 ， 处 理 这 个 请 求 的 控制 器 方法 返回 了 该 用 
户 不 允许 看 到 的 数据 。 这 是 一 个 无 心 之 失 ， 不过， 安全 问题 很 可 能 就 是 
无 心 之 失 所 造成 的 ， 因 为 他 们 是 非常 取 明 的 攻击 者 。 


我 们 可 以 同时 保护 应 用 的 Web 层 以 及 场景 后 面 的 方法 ， 这 样 就 能 保证 如 
果 用 户 不 具备 权限 的 话 ， 就 无 法 执行 相应 的 逻辑 。 


在 本 章 中 ， 我 们 将 会 看 到 如 何 使 用 Spring Security 保 护 bean 方 法 。 通 过 这 
种 方式 ， 就 能 声明 安全 规则 ， 保 证 如 果 用 户 没 有 执行 方法 的 权限 ， 就 不 
会 执行 相应 的 方法 。 首 先 ， 我 们 会 看 一 些 可 以 放 在 方法 上 的 简单 注解 ， 
它们 能 够 将 方法 锁定 ， 阻 止 无 权限 用 户 的 访问 。 



































14.1 使 用 注解 保护 方法 


在 Spring Security 中 实现 方法 级 安全 性 的 最 常见 办 法 是 使 用 特定 的 注 

解 ， 将 这 些 注 解 应 用 到 需要 保护 的 方法 上 。 这 样 有 几 个 好 处 ， 最 重要 的 
是 当 我 们 在 编辑 器 中 查看 给 定 的 方法 时 ， 能 够 很 清楚 地 看 到 它 的 安全 规 
则 。 


Spring Security 提 供 了 三 种 不 同 的 安全 注解 : 





。 Spring Security 自 带 的 @Secured 注 解 ; 

。 JSR-250 的 @RolesAllowed 注 解 ; 

。 表达 式 驱 动 的 注解 ， 包 括 
@PreAuthorize、@PostAuthorize、@PreFilter 和 和 
@PostFilter.。 





@Secured 和 @RolesAllowed 方 案 非 党 类似， 能 够 基于 用 户 所 授予 的 权 
限 限制 对 方法 的 访问 。 当 我 们 需要 在 方法 上 定义 更 灵活 的 安全 规则 时 ， 
Spring Security 提 供 了 @PreAuthorize 和 @PostAuthorize， 

而 @PreFilter/@PostFilter 能 够 过 滤 方 法 返回 的 以 及 传 入 方法 的 集 


Do 


在 本 章 中 ， 你 将 会 看 到 如 何 使 用 这 些 注解 。 作 为 开始 ， 我 们 首先 看 一 
ee 这 是 Spring Security 所 提供 的 方法 级 安全 注解 里 面 最 
简单 的 一 个 。 


14.1.1 ”使 用 @Secured 注 解 限制 方法 调用 


在 Spring 中 ， 如 果 要 局 用 基于 注解 的 方法 安全 性 ， 关 键 之 处 在 于 要 在 配 
置 类 上 使 用 @EnableGlobalMethodSecurity， 如 下 所 示 : 





@Configuration 
@EnableGlobalMethodSecurity(securedEnabled=true) 


public class MethodSecurityConfig 
extends GlobalMethodSecurityConfiguration { 
} 





除了 使 用 @EnableGlobalMethodSecurity 注 解 ， 我 们 可 能 也 注意 到 配 


置 类 扩展 了 GlobalMethodsecurityConfiguration。 在 第 9 章 中 ， 
Web 安 全 的 配置 类 扩展 了 WebsecurityConfigurerAdapter， 与 之 类 
似 ， 这 个 类 能 够 为 方法 级 别 的 安全 性 提供 更 精细 的 配置 。 


例如 ， 如 果 我 们 在 Web 层 的 安全 配置 中 设置 认证 ， 那 么 可 以 通过 重 
载 GlobalMethodSsecurityConfiguration 的 configure() 方 法 实现 该 
功能 : 





@Override 
protected void configure(AuthenticationManagerBuilder auth) 
throws Exception { 


auth 
.inMemoryAuthentication() 
.WithUser("user").password("password").roles("USER"); 





在 本 章 稍 后 的 14.2.2 小 节 中 ， 我 们 将 会 看 到 如 何 重 

载 GlobalMethodSecurity-Configuration 的 
createExpressionHandler() 方 法 ， 提 供 一 些 自 定 义 的 安全 表达 式 处 
理 行为 。 


让 我 们 回 到 @EnableGlobalMethodSecurity 注 解 ， 注 意 它 的 
securedEnabled 属 性 设置 成 了 true。 如 果 securedEnabled 属 性 的 值 
为 true 的 话 ， 将 会 创建 一 个 切 点 ， 这 样 的 话 Spring Security 切 面 束 会 包 
装 带 有 @Secured 注 解 的 方法 。 例 如 ， 考 虑 如 下 这 个 带 有 @Secured 注 解 
的 addSpittle( ) 方 法 : 


@Secured("ROLE_ SPITTER") 
public void addSpittle(Spittle spittle) { 


/A ra 
} 


@Secured 注 解 会 使 用 一 个 String 数 组 作为 参数 。 每 个 String 值 是 一 个 权 
限 ， 调 用 这 个 方法 至 少 需要 具备 其 中 的 一 个 权限 。 通 过 传递 进 

来 ROLE_SPITTER， 我 们 告诉 Spring Security 只 允许 具有 ROLE_SPITTER 
权限 的 认证 用 户 才能 调用 addspittle () 方 法 。 


如 果 传 递 给 @Secured 多 个 权限 值 ， 认 证 用 户 必须 至 少 具备 其 中 的 一 个 
才能 进行 方法 的 调 有 用。 例如， 下面 使 用 @Secured 的 方式 表明 用 户 必须 





具备 ROLE_SPITTER 或 ROLE_ADMIN 权 限 才 能 触发 这 个 方法 : 


@Secured({"ROLE_ SPITTER", "ROLE ADMIN"}) 
public void addSpittle(Spittle spittle) { 


Lh Bx 
} 


如 采 方 法 被 没有 认证 的 用 户 或 没有 所 需 权 限 的 用 户 调用 ， 保 护 这 个 方法 
的 切面 将 抛 出 一 个 Spring Security 异 常 (可 能 

是 AuthenticationException 或 AccessDeniedException 的 子 类 ) 。 
它们 是 非 检查 型 异常 ， 但 这 个 异常 最 终 必 须要 被 捕获 和 处 理 。 如 果 被 保 
护 的 方法 是 在 web 请求 中 调用 的 ， 这 个 异常 会 被 Spring Security 的 过 滤 右 
自动 处 理 。 否 则 的 话 ， 你 需要 编写 代码 来 处 理 这 个 异 第 。 


@Ssecured 注 解 的 不 足 之 处 在 于 它 是 Spring 特定 的 注解 。 如 果 更 倾 癌 于 使 
用 Java 标 准 定义 的 注解 ， 那 么 你 应 该 考虑 使 用 @RolesAllowed 注 解 。 














14.1.2 ”在 Spring Security 中 使 用 JSR-250 的 @RolesAllowed 注 
解 

@RolesAllowed 注 解 和 @Secured 注 解 在 各 个 方面 基本 上 都 是 一 致 的 。 
唯一 显著 的 区 别 在 于 @RolesAllowed 是 JSR-250 定 义 的 Java 标 准 注解 。 


差异 更 多 在 于 政治 考量 而 非 技 术 因 素 。 但 是 ， 当 使 用 其 他 框架 或 API 来 
处 理 注解 的 话 ， 使 用 标准 的 @RolesAllowed 注 解 会 更 有 意义 。 


如 果 选 择 使 用 @RolesAllowed 的 话 ， 需 要 
将 @EnableGlobalMethodSecurity 的 jsr256Enabled 属 性 设置 
为 true， 以 开启 此 功能 : 





@Configuration 
@EnableGlobalMethodSecurity(jsr2586Enabled=true) 


public class MethodSecurityConfig 
extends GlobalMethodSecurityConfiguration { 


} 





尽管 我 们 这 里 只 是 启用 了 jsr2586Enabled， 但 需要 说 明 的 一 点 是 这 
与 securedEnabled 并 不 冲突 。 这 两 种 注解 风格 可 以 同时 启用 。 


在 将 jsr256Enabled 设 置 为 true 之 后 ， 将 会 启用 一 个 切 点 ， 这 样 带 
有 @RolesAllowed 注 解 的 方法 都 会 被 Spring Security 的 切面 包装 起 来 。 
因此 ， 在 方法 上 使 用 @RolesAllowed 的 方式 与 使 用 @Secured 类 似 。 例 
如 ， 如 下 的 addSpittle() 方 法 使 用 了 @RolesAllowed 注 解 来 代替 


@Secured: 





@RolesAllowed("ROLE_ SPITTER") 
public void addSpittle(Spittle spittle) { 


二 
} 








尽管 @RolesAllowed 比 @Secured 在 政治 上 稍微 有 点 优势 ， 它 是 实现 方 
法 安全 的 标准 注解 ， 但 是 这 两 个 注解 有 一 个 共同 的 不 足 。 它 们 只 能 根据 
用 户 有 没有 授予 特定 的 权限 来 限制 方法 的 调用 。 在 判断 方式 是 否 执 行 方 
面 ， 无 法 使 用 其 他 的 因素 。 我 们 在 第 9 章 曾 经 看 到 过 ， 在 保护 URIL 方 

面 ， 能 够 使 用 SpEL 表 达 式 克服 这 一 限制 。 接 下 来 ， 我 们 看 一 下 如 何 组 
合 使 用 SpEL 与 Spring Security 所 提供 的 方法 调用 前 后 注解 ， 实 现 基 于 表 
达 式 的 方法 安全 性 。 











14.2 ”使 用 表达 式 实现 方法 级 别 的 安全 性 


尽管 @Secured 和 @RolesAllowed 注 解 在 拒绝 未 认证 用 户 方面 表现 不 
错 ， 但 这 也 是 它们 所 能 做 到 的 所 有 事情 了 。 有 时 候 ， 安 全 性 约束 不 仅仅 
涉及 用 户 是 否 有 权限 。 


Spring Security 3.0 引 入 了 儿 个 新 注解 ， 它 们 使 用 SpEL 能 够 在 方法 调用 上 
实现 更 有 意思 的 安全 性 约束 。 这 些 新 的 注解 在 表 14.1 中 进行 了 描述 。 

这 些 注解 的 值 参 数 中 都 可 以 接受 一 个 SpEL 表 达 式 。 表 达 式 可 以 是 任意 
合法 的 SpEL 表 达 式 ， 可 能 会 包含 表 9.5 所 列 的 Spring Security 对 SpEL 的 扩 
展 。 如 果 表 达 式 的 计算 结果 为 true， 那 么 安全 规则 通过 ， 和 否则 就 会 失 
败 。 安 全 规则 通过 或 失败 的 结果 会 因为 所 使 用 注解 的 差异 而 有 上 所 不 同 。 


表 14.1 Spring Security 3.0 提 供 了 4 个 新 的 注解 ， 可 以 使 用 SpEL 表 达 式 来 保护 方法 调用 


基于 表达 式 的 计算 结果 来 限制 对 方法 的 访问 






























































@PostAuthorize F 方 法 调用 ， 但 是 如 果 表 达 式 计算 结果 为 false， 将 抛 出 一 个 安全 


性 异常 


方法 调用 ， 但 必须 楼 限 表 达 式 来 过 江 方 法 的 
和 方法 调用 ， 但 必须 在 进入 方法 之 前 过 法 输入 人 


稍 后， 我 们 将 会 看 到 每 个 注解 的 例子 。 但 首先 ， 我 们 需要 
将 @EnableGlobalMethod-Security 注 解 的 prePostEnabled 属 性 设置 
为 true， 从 而 局 用 它们 : 
































@Configuration 
@EnableGlobal MethodSecurity(prePostEnabled=true) 
public class MethodSecurityConfig 


extends GlobalMethodSecurityConfiguration { 
} 


现在 ， 方 法 调用 前 后 的 注解 都 已 经 启用 了 ， 我 们 可 以 使 用 它们 了 。 我 们 
首先 看 一 下 如 何 使 用 @preAuthorize 和 @PostAuthorize 注 解 限制 对 方 
法 的 调用 。 


14.2.1 表述 方法 访问 规则 


到 目前 为 止 ， 我们 已 经 看 到 @Secured 和 @RolesAllowed 能 够 限制 只 有 
用 户 有 具备 所 需 的 权限 才能 触发 方法 的 执行 。 但 是 ， 这 两 个 注解 的 不 足 在 
于 它们 只 能 基于 用 户 授 予 的 权限 来 做 出 决策 。 


Spring Security 还 提供 了 两 个 注解 ，@PreAuthorize 和 
@PostAuthorize， 它 们 能 够 基于 表达 式 的 计算 结果 来 限制 方法 的 访 
问 。 在 定义 安全 限制 方面 ， 表 达 式 带 了 极 大 的 灵活 性 。 通 过 使 用 表达 
ee 就 可 以 定义 任意 允许 访问 或 不 允许 访问 方 
法 的 条 件 。 


@PreAuthorize 和 @PostAuthorize 之 间 的 关键 区 别 在 于 表达 式 执 行 的 
时 机 。@PreAuthorize 的 表达 式 会 在 方法 调用 之 前 执行 ， 如 果 表 达 式 的 
计算 结果 不 为 true 的 话 ， 将 会 阻止 方法 执行 。 与 之 相 

反 ，@PostAuthorize 的 表达 式 直 到 方法 返回 才 会 执行 ， 然 后 决定 是 盏 
抛 出 安全 性 的 异常 。 


在 方法 调用 前 验证 权限 
@PreAuthorize 千 看 起 来 可 能 只 是 添加 了 SpEL 支 持 的 @Secured 和 


@RolesAllowed。 实 际 上 ， 你 可 以 基于 用 户 所 授予 的 角色 ， 使 
用 @PreAuthorize 来 限制 访问 : 








@PreAuthorize("hasRole('ROLE_ SPITTER')") 
public void addSpittle(Spittle spittle) { 


A 
} 








如 果 按 照 这 种 方式 的 话 ，@PreAuthorize 相 对 于 @Secured 和 
@RolesAllowed 并 没有 什么 优势 。 如 果 用 户 具有 ROLE_SPITTER 角 色 的 
话 ， 人 允许 方法 调用 。 否 则 ， 将 会 抛 出 安全 性 异常 ， 方 法 也 不 会 执行 。 


但 是 ，@PreAuthorize 的 功能 并 不 限于 这 个 简单 例子 所 展现 

的 。@PreAuthorize 的 String 类 型 参数 是 一 个 SpEL 表 达 式 。 借 助 于 
SpEL 表 达 式 来 实现 访问 决策 ， 我 们 能 够 编写 出 更 高 级 的 安全 性 约束 。 
例如 ，Spittr 应 用 程序 的 一 般 用 户 只 能 写 140 个 字 以 内 的 Spittle， 而 付费 
用 户 不 限制 字数 。 


虽然 @Secured 和 @RolesAllowed 在 这 里 无 能 为 力 ， 但 
是 @PreAuthorize 注 解 恰 好 能 够 适用 于 这 种 场景 : 


@PreAuthorize( 
"(hasRole('ROLE_ SPITTER') and #spittle.text.length() <= 1406)" 
+"or hasRole('ROLE PREMIUM' )") 


public void addSpittle(Spittle spittle) { 
YY 
} 








表达 式 中 的 #spittle 部 分 直接 引用 了 方法 中 的 同名 参数 。 这 使 得 Spring 
Security 能 够 检查 传 入 方法 的 参数 ， 并 将 这 些 参数 用 于 认证 决策 的 制 
定 。 在 这 里 ， 我 们 深入 到 spitter 的 文本 内 容 中 ， 保 证 不 超过 Spittr 标 准 
用 户 的 长 度 限制 。 如 果 是 付费 用 户 ， 那 么 就 没有 长 度 限制 了 。 


在 方法 调用 之 后 验证 权限 


在 方法 调用 之 后 验证 权限 并 不 是 比较 常见 的 方式 。 事 后 验证 一 般 需 要 基 
于 安全 保护 方法 的 返回 值 来 进行 安全 性 决策 。 这 种 情况 意味 着 方法 必须 
被 调用 执行 并 且 得 到 了 返回 值 。 


例如 ， 假 设 我 们 想 对 getSpitt1leById() 方 法 进行 保护 ， 确 保 返 回 的 
Spittle 对 象 属于 当前 的 认证 用 户 。 我 们 只 有 得 到 spittle 对 象 之 后 ， 
才能 判断 它 是 否 属于 当前 用 户 。 因 此 ，getSpittleById() 方 法 必须 要 
0 在 得 到 Spittle 之 后 ， 如 果 它 不 属于 当前 用 户 的 话 ， 将 会 抛 出 
安全 性 异常 。 


除了 验证 的 时 机 之 外 ，@PostAuthorize 与 OpreAuthorize 的 工作 方式 
差不多 ， 只 不 过 它 会 在 方法 执行 之 后 ， 才 会 应 用 安全 规则 。 此 时 ， 它 才 
有 机 会 在 做 出 安全 决策 时 ， 考 虑 到 返回 值 的 因素 。 


例如 ， 要 保护 上 面 描述 的 getspittleById() 方 法 ， 我 们 可 以 按照 如 下 
的 方式 使 用 @PostAuthorize 注 解 : 








@PostAuthorize("returnObject.spitter.username == principal.username") 
public Spittle getSpittleById(long id) { 


} 


为 了 便利 地 访问 受 保护 方法 的 返回 对 象 ，Spring Security 在 SpEL 中 提供 
了 名 为 return0bJject 的 变量 。 在 这 里 ， 我 们 知道 返回 对 象 是 一 
个 spittle 对 象 ， 所 以 这 个 表达 式 可 以 直接 访问 其 spittle 属 性 中 的 


username 属 性 。 








在 对 比 表 达 式 双 等 写 的 男 一 侧 ， 表 达 式 到 内 置 的 principal 对 象 中 取出 
其 username 属 性 。principal 是 另 一 个 Spring Security 内 置 的 特殊 名 
称 ， 它 代表 了 当前 认证 用 户 的 主要 信息 (通常 是 用 户 名 ) 。 


在 Spittle 对 象 所 包含 spitter 中 ， 如 果 username 属 性 与 principal 的 
username 属 性 相同 ， 这 个 spittle 将 返回 给 调用 者 。 否 则 ， 会 抛 出 一 
个 AccessDeniedException 异 常 ， 而 调用 者 也 不 会 得 到 Spittle 对 





有 一 点 需要 注意 ， 不 像 @QPreAuthorize 注 解 所 标注 的 方法 那 
样 ，@PostAuthorize 注 解 的 方法 会 首先 执行 然后 被 拦截 。 这 意味 着 ， 
你 需要 小 心 以 保证 如 果 验 证 失败 的 话 不 会 有 一 些 负 面 的 结果 。 


14.2.2 过滤 方 法 的 输入 和 输出 


如 果 我 们 希望 使 用 表达 式 来 保护 方法 的 话 ， 那 使 用 @PreAuthorize 和 
@PostAuthorize 是 非常 好 的 方案 。 但 是 ， 有 了 时候 限 制 方法 调用 太 严 格 
了 。 有 时 ， 需 要 保护 的 并 不 是 对 方法 的 调用 ， 需 要 保护 的 是 传 入 方法 的 
数据 和 方法 返回 的 数据 。 


例如 ， 我 们 有 一 个 名 为 getOffensiveSpittles() 的 方法 ， 这 个 方法 会 
返回 标记 为 具有 攻击 性 的 Spittle 列 表 。 这 个 方法 主要 会 给 管理 员 使 
用 ， 以 保证 Spittr 应 用 中 内 容 的 和 谐 。 但 是 ， 普 通用 户 也 可 以 使 用 这 
个 方法 ， 用 来 查看 他 们 所 发 布 的 Spittle 有 没有 被 标记 为 具有 攻击 性 。 
这 个 方法 的 签名 大 致 如 下 所 示 ; 


public List<Spittle> getoffensiveSpittles() { ... } 




















按照 这 种 方法 的 定义 ，getOoffensiveSspittles(1) 方 法 与 具体 的 用 户 并 
没有 关联 。 它 只 会 返回 攻击 性 spittle 的 一 个 列表 ， 并 不 关心 它们 属于 
哪个 用 户 。 对 于 管理 员 使 用 来 说 ， 这 是 一 个 很 好 的 方法 ， 但 是 它 无 法 限 
制 列表 中 的 Spittle 都 属于 当前 用 户 。 


当然 ， 我 们 也 可 以 重 载 getoffensiveSpittles()， 实 现 另 一 个 版 本 ， 
让 它 接受 一 个 用 户 ID 作 为 参数 ， 查 询 给 定 用户 的 Spittle。 但 是 ， 正 如 
我 在 本 章 开 头 所 讲 的 那样 ， 始 终 会 有 这 样 的 可 能 性 ， 那 就 是 将 较为 宽松 
限制 的 版 本 用 在 具有 一 定安 全 限制 的 场景 中 。 半 | 


我 们 需要 有 一 种 方式 过 滤 getoffensiveSpittles() 方 法 返回 的 
Spittle 和 集合 ， 将 结果 限制 为 允许 当前 用 户 看 到 的 内 容 ， 而 这 束 是 
Spring Security 的 @PostFilter 所 能 做 的 事情 。 我 们 来 试 一 下 。 


事后 对 方法 的 返回 值 进行 过 小 


与 @PreAuthorize 和 @PostAuthorize 类 似 ，@PostFilter 也 使 用 一 个 
SpEL 作 为 值 参数 。 但 是 ， 这 个 表达 式 不 是 用 来 限制 方法 访问 

的 ，@PostFilter 会 使 用 这 个 表达 式 计 算 该 方法 所 返回 集合 的 每 个 成 
员 ， 将 计算 络 末 为 false 的 成 员 移 除 掉 。 


为 了 曾 述 该 功能 ， 我 们 将 @PostFilter 应 用 
在 getOffensiveSpittles() 方 法 上 : 











@PreAuthorize("hasAnyRole({'ROLE SPITTER', 'ROLE ADMIN'})") 
@PostFilter( "hasRole('ROLE ADMIN') || " 


+ "filterObject.spitter.username == principal.name") 


public List<Spittle> getoffensiveSpittles() { 


} 





在 这 里 ，@PreAuthorize 限 制 只 有 有 具备 ROLE_SPITTER 或 ROLE_ADMIN 
权限 的 用 户 才能 访问 该 方法 。 如 果 用 户 能 够 通过 这 个 检查 点 ， 那 么 方法 
将 会 执行 ， 并 且 会 返回 spittle 所 组 成 的 一 个 List。 但 

是 ，@PostFilter 注 解 将 会 过 小 这 个 列表 ， 确 保 用 户 只 能 看 到 允许 的 
Spittle。 具 体 来 讲 ， 管 理 员 能 够 看 到 所 有 攻击 性 的 Spittle， 非 管理 
员 只 能 看 到 属于 自己 的 Spittle。 


表达 式 中 的 位 lter0bject 对 象 引 用 的 是 这 个 方法 所 返回 List 中 的 某 一 








个 元 素 (我 们 知道 它 是 一 个 Spittle) 。 在 这 个 Spittle 对 象 中 ， 如 果 
Spitter 的 用 户 名 与 认证 用 户 〈( 表 达 式 中 的 principal.name〉 相同 或 者 用 
户 具 有 ROLE_ADMIN 角 色 ， 那 这 个 元 素 将 会 最 终 包含 在 过 小 后 的 列表 
中 。 奋 则 ， 它 将 被 过 滤 挥 。 


事先 对 方法 的 参数 进行 过 小 


除了 事后 过 滤 方 法 的 返回 值 ， 我 们 还 可 以 预先 过 滤 传 入 到 方法 中 的 值 。 
这 项 技术 不 太 常 用， 但 是 在 有 些 场 景 下 可 能 会 很 便利 。 


例如 ， 假 设 我 们 希望 以 批 处 理 的 方式 删除 Spittle 组 成 的 列表 。 为 了 完 
成 该 功能 ， 我 们 可 能 会 编写 一 个 方法 ， 其 签名 大 致 如 下 所 示 : 


public void deleteSpittles(List<Spittle> spittles) { ... } 


看 起 来 很 简单 ， 对 吧 ? 但 是 ， 如 果 我 们 想 在 它 上 面 应 用 一 些 安全 规则 的 
话 ， 比 如 Spittle 只 能 由 其 所 有 者 或 管理 员 删 除 ， 那 该 怎么 做 呢 ? 如 果 
是 这 样 的 话 ， 我 们 可 以 将 多 辑 放 在 deleteSpittles() 方 法 中 ， 在 这 里 
循环 列表 中 的 Spittle， 只 删除 属于 当前 用 户 的 那 一 部 分 对 象 “如果 当 
前 用 户 是 管理 员 的 话 ， 则 会 全 部 删除 ) 。 


这 能 够 运行 正常 ， 但 是 这 意味 着 我 们 需要 将 安全 逻辑 直接 租 入 到 方法 之 
中 。 相 对 于 删除 Spittle 来 讲 ， 安 全 逻辑 是 独立 的 关注 点 (当然 ， 它 们 
也 有 所 关联 ) 。 如 果 列 表 中 能 够 只 包含 实际 要 删除 的 Spittle， 这 样 会 
更 好 一 些 ， 因 为 这 能 帮助 deleteSpittles(1) 方 法 中 的 逻辑 更 加 简单 ， 
只 关注 于 删除 Spittle 的 任务 。 


Spring Security 的 @PreFilter 注 解 能 够 很 好 地 解决 这 个 问题 。 

与 @PostFilter 非 常 类 似 ，@PreFilter 也 使 用 SpEL 来 过 滤 集 合 ， 只 有 
满足 SpEL 表 达 式 的 元 素 才 会 留 在 集合 中 。 但 是 它 所 过 滤 的 不 是 方法 的 
返回 值 ，@PreFilter 过 滤 的 是 要 进入 方法 中 的 集合 成 员 。 


@PreFilter 的 使 用 非常 简单 。 如 下 的 deleteSpittles() 方 法 使 用 了 
@PreFilter 注 解 : 























@PreAuthorize("hasAnyRole({'ROLE SPITTER', 'ROLE ADMIN'})") 
@PreFilter( "hasRole('ROLE ADMIN') || " 

+ "targetObject.spitter.username == principal.name") 
public void deleteSpittles(List<Spittle> spittles) { ... } 


与 前 面 一 样 ， 对 于 没有 ROLE_SPITTER 或 ROLE_ADMIN 权 限 的 用 

户 ，@PreAuthorize 注 解 会 阻止 对 这 个 方法 的 调用 。 但 同 

时 ，@PreFilter 注 解 能 够 保证 传递 给 deleteSspittles() 方 法 的 列表 
中 ， 只 包含 当前 用 户 有 权限 删除 的 Spittle。 这 个 表达 式 会 针对 集合 中 
的 每 个 元 素 进 行 计算 ， 只 有 表达 式 计算 结果 为 true 的 元 系 才 会 保留 在 列 
表 中 。target0bject 是 Spring Security 提 供 的 另外 一 个 值 ， 它 代表 了 要 
进行 计算 的 当前 列表 元 素 。 


Spring Security 提 供 了 注解 驱动 的 功能 ， 这 是 通过 一 系列 注解 来 实现 
的 ， 到 此 为 止 ， 我们 已 经 对 这 些 注解 进行 了 介绍 。 相 对 于 判断 用 户 所 授 
予 的 权限 ， 使 用 表达 式 来 定义 安全 限制 是 一 种 更 为 强大 的 方式 。 


即便 如 此 ， 我 们 也 不 应 该 让 表达 式 过 于 聪明 智能 。 我 们 应 该 避免 编写 非 
常 复 森 的 安全 表达 式 ， 或 者 在 表达 式 中 舰 入 太 多 与 安全 无 天 的 业务 好 

辑 。 而 且 ， 表 达 式 最 终 只 是 一 个 设置 给 注解 的 String 值 ， 因 此 它 很 难 

测试 和 调试 。 


如 果 你 觉得 自己 的 安全 表达 式 难 以 控制 了 ， 那 么 就 应 该 看 一 下 如 何 编写 
自 定 义 的 许可 计算 器 (permission evaluator) ， 以 简化 你 的 SpEL 表 达 
式 。 下 面 我 们 看 一 下 如 何 编写 自 定义 的 许可 计算 器 ， 用 它 来 简化 之 前 用 
下 过 让 的 表 人 3 

定义 许可 计算 器 

我 们 在 @PreFilter 和 @PostFilter 中 所 使 用 的 表达 式 还 算 不 上 太 复 
杂 。 但 是 ， 它 也 并 不 简单 ， 我 们 可 以 很 容易 地 想象 如 果 还 要 实现 其 他 的 
安全 规则 ， 这 个 表达 式 会 不 断 膨 胀 。 在 变 得 很 长 之 前 ， 表 达 式 就 会 答 
重 、 复 杂 且 难以 测试 。 


其 实 我 们 能 够 将 整个 表达 式 蔡 换 为 更 加 简单 的 版 本 ， 如 下 所 示 : 
































@PreAuthorize("hasAnyRole({'ROLE SPITTER', 'ROLE ADMIN'})") 


@PreFilter("hasPpermission(targetObject, 'delete')") 
public void deleteSpittles(List<Spittle> spittles) { ... } 








现在 ， 设 置 给 @PreFilter 的 表达 式 更 加 紧凑 。 它 实际 上 只 是 在 问 一 个 
问题 “用 户 有 权限 删除 目标 对 象 吗 ?”。 如 果 有 的 话 ， 表 达 式 的 计算 结果 


为 true，Spittle 会 保存 在 列表 中 ， 并 传递 给 deleteSpittles() 方 
法 。 如 果 没 有 权限 的 话 ， 它 将 会 被 移 除 掉 。 


但 是 ，hasPermission() 是 哪 来 的 呢 ? 它 的 意思 是 什么 ? 更 为 重要 的 
是 ， 它 如 何 知 道 用 户 有 没有 权限 删除 targetoObject 所 对 应 的 Spitt1le 
呢 ? 


hasPermission() 函 数 是 Spring Security 为 SpEL 提 供 的 扩展 ， 它 为 开发 
者 提供 了 一 个 时 机 ， 能 够 在 执行 计算 的 时 候 插 入 任意 的 逻辑 。 我 们 所 需 
要 做 的 就 是 编写 并 注册 一 个 自 定 义 的 许可 计算 器 。 程 序 清单 14.1 展 现 了 
SpittlePermissionEvaluator 类 ， 它 就 是 一 个 自 定 义 的 许可 计算 

器 ， 包 含 了 表达 式 逻 辑 。 


程序 清单 14.1 许可 计算 器 为 hasPermission(0 提 供 实现 逻辑 





package spittr.security; 

import java.io.Serializable; 

import org.springframework.security.access.PermissionEvaluator; 
import org.springframework.security.core.Authentication; 

import spittr.Spittle; 


public class SpittlePpermissionEvaluator implements PermissionEvaluator { 


private static final GrantedAuthority ADMIN AUTHORITY = 
new GrantedAuthorityImpl("ROLE ADMIN"); 
public boolean hasPermission(Authentication authentication， 
Object target, Object permission) { 


if (target instanceof Spittle) { 
Spittle spittle = (Spittle) target; 
String username = spittle.getSpitter().getUsername(); 
if ("delete".equals(permission)) { 
return isAdmin(authentication) || 
username.equals(authentication.getName()); 


} 


throw new UnsupportedOperationException( 
"hasPermission not supported for object <" + target 
+ "> and permission <" + permission + ">"); 


public boolean hasPermission(Authentication authentication， 
Serializable targetId, String targetType, Object permission) { 
throw new UnsupportedOperationException(); 


private boolean isAdmin(Authentication authentication) { 
return authentication.getAuthorities().contains(ADMIN AUTHORITY); 





SpittlePermissionEvaluator 实 现 了 Spring Security 的 








PermissionEvaluator 接 口 ， 它 需要 实现 两 个 不 同 的 

hasPermission() 方 法 。 其 中 的 一 个 hasPermission() 方 法 把 要 评估 
的 对 象 作 为 第 二 个 参数 。 第 二 个 hasPermission() 方 法 在 只 有 目标 对 
R00 


为 了 满足 我 们 的 需求 ， 我 们 假设 使 用 spittle 对 象 来 评估 权限 ， 所 以 第 
二 个 方法 只 是 简单 地 抛 出 UnsupportedoperationException。 


对 于 第 一 个 hasPermission() 方 法 ， 要 检查 所 评估 的 对 象 是 否 为 一 
个 Spittle， 并 判断 所 检查 的 是 否 为 删除 权限 。 如 果 是 这 样 ， 它 将 对 比 
Spitter 的 用 户 名 是 否 与 认证 用 户 的 名 称 相 等 ， 或 者 当前 用 户 是 否 具 
有 ROLE_ADMIN 权 限 。 


许可 计算 器 已 经 准备 就 绪 ， 接 下 来 需要 将 其 注册 到 Spring Security 中 ， 
以 便 在 使 用 @PreFilter 表 达 式 的 时 候 支 持 hasPermission() 操 作 。 为 
了 实现 该 功能 ， 我 们 需要 替换 原 有 的 表达 式 处 理 器 ， 换 成 使 用 自 定义 许 
可 计算 器 的 处 理 器 。 


默认 情况 下 ，Spring Security 会 配置 为 使 

用 DefaultMethodSecurityExpression-Handler， 它 会 使 用 一 

个 DenyAllPermissionEvaluator 实 例 。 顾 名 思 义 ，Deny- 
AllPermissionEvaluator 将 会 在 hasPermission() 方 法 中 始终 返回 
false， 拒 绝 所 有 的 方法 访问 。 但 是 ， 我 们 可 以 为 Spring Security 提 供 另 
外 一 个 DefaultMethod-SecurityExpressionHandler， 让 它 使 用 我 
们 自 定义 的 SpittlePermissionEvaluator， 这 需要 重 

载 GlobalMethodSecurityConfiguration 的 
createExpressionHandler 方 法 : 














@Override 
protected MethodSecurityExpressionHandler createExpressionHandler() { 
DefaultMethodSecurityExpressionHandler expressionHandler = 


new DefaultMethodSecurityExpressionHandler(); 
expressionHandler.setPermissionEvaluator( 
new SpittlePermissionEvaluator()); 
return expressionHandler; 


} 





现在 ， 我 们 不 管 在 任何 地 方 的 表达 式 中 使 用 hasPermission( ) 来 保护 





方法 ， 都 会 调用 SpittlePermissionEvaluator 来 决定 用 户 是 否 有 权 
限 调用 方法 。 





14.3 ”小 结 


方法 级 别 的 安全 性 是 Spring Security Web 级 别 安全 性 的 一 个 重要 补充 ， 
我 们 曾 在 第 9 章 讨 论 过 Web 安 全 性 。 对 于 非 Web 应 用 来 说 ， 方 法 级 别 的 
安全 性 则 是 最 前 沿 的 防护 。 对 于 Web 应 用 来 讲 ， 基 于 安全 规则 所 声明 的 
方法 级 别 安 全 性 能 够 保护 Web 请 求 。 


在 本 章 中 ， 我 们 看 到 了 六 个 可 以 在 方法 上 声明 安全 性 限制 的 注解 。 对 于 
简单 场景 来 说 ， 面 同 权 限 的 注解 ， 包 括 Spring Security 的 @Secured 以 及 
基于 标准 的 @RolesAllowed 都 很 便利 。 当 安全 规则 更 为 复杂 的 时 候 ， 组 
合 使 用 @PreAuthorize、@PostAuthorize 以 及 SpEL 能 够 发 挥 更 强大 的 
威力 。 我 们 还 看 到 通过 为 @PreFilter 和 @PostFilter 提 供 SpEL 表 达 
式 ， 过 滤 方 法 的 输入 和 输出 。 


最 后 ， 我 们 还 看 到 了 让 安全 规则 更 加 易于 维护 、 测 试 和 调试 的 方法 ， 那 
就 是 自 定义 表达 式 计算 器 ， 它 能 够 用 在 SpEL 表 达 式 的 
hasPermission() 函 数 中 。 


从 下 一 章 开 始 ， 我 们 将 会 转移 方向 ， 从 使 用 Spring 开发 后 端 应 用 程序 转 
问 与 其 他 应 用 集成 。 在 接 下 来 的 几 章 中 ， 我 们 将 会 看 到 各 种 集成 技术 ， 

包括 远程 服务 、 异 步 消息 、REST 甚 至 还 有 发 送 E-mail。 在 下 一 章 我 们 将 
会 探讨 第 一 项 集成 技术 ， 也 就 是 使 用 Spring 远程 服务 。 














[1] 除 此 之 外 ， 如 果 重 载 getOffensiveSpittles() 方 法 的 话 ， 我 必须 再 绞 尽 脑 
汗 想 一 个 例子 出 来 ， 以 展现 如 何 使 用 SpEL 过 小 方法 的 输出 。 


第 4 部 分 “Spring 集成 


应 用 程序 都 不 是 扳 岛 。 如 今 ， 企 业 级 应 用 程序 必须 要 与 其 他 的 系统 协作 
才能 完成 其 目标 。 在 第 4 部 分 ， 你 将 会 学 到 如 何 路 越 应 用 程序 本 身 的 边 
界 ， 与 其 他 的 应 用 程序 和 企业 级 服务 实现 集成 。 


在 第 15 章 “使 用 远程 服务 ”中 ， 你 会 学 到 如 何 将 应 用 程序 中 的 对 象 导 出 为 
远程 服务 ， 还 会 学 习 如 何 透 明 地 访问 远程 服务 ， 这 些 服务 就 像 是 应 用 程 
序 中 的 其 他 对 象 一 样 。 我 们 将 会 介绍 各 种 远程 技术 ， 包 括 RMI、 
Hessian/Burlap 以 及 使 用 JAX-WS 的 SOAP Web 服 务 。 


与 第 15 章 所 介绍 的 RPC 风 格 的 远程 服务 不 同 ， 第 16 章 “使 用 Spring MVC 
创建 REST APT 将 会 探讨 如 何 使 用 Spring MVC 构 建 RESTful 服 务 ， 它 关 
注 于 应 用 程序 中 的 资源 。 


第 17 章 “Spring 消 息 ” 将 会 探索 一 种 不 同 的 应 用 集成 方式 ， 也 就 是 Spring 
如 何 用 于 Java 消 息 服 务 (Java Message Service，JMS) 和 高 级 消息 队列 
协议 (Advanced Message Queuing Protocol，AMQP ) ， 从 而 实现 应 用 程 
序 之 间 的 异步 通信 。 


Web 应 用 需要 越 来 越 多 的 交互 性 ， 我 们 希望 它 能 展现 实时 的 数据 。 第 18 
章 “ 使 用 WebSocket 和 STOMP 实 现 消息 功能 ”将 会 展现 Spring 的 一 项 新 功 
能 ， 它 支持 在 服务 器 和 Web 客 户 端 之 间 实 现 异 步 通信 。 


另外 一 种 形式 的 异步 通信 不 一 定 发 生 在 应 用 程序 之 间 。 在 第 19 章 “使 用 
Spring 发 送 Email” 中 ， 将 会 展现 如 何 借助 Spring 以 Email 的 形式 发 送 异 步 
消息 给 目标 人 群 。 


管理 和 监控 Spring bean 是 第 20 章 “使 用 JMX 管 理 Spring Bean” 的 主题 。 在 
该 章 中 ， 你 会 学 到 如 何 把 配置 在 Spring 中 bean 目 动 导 出 为 JMX MBean。 


本 书 的 结尾 是 很 新 但 是 很 必要 的 内 容 。 第 21 章 “借助 Spring Boot 简 化 
Spring 开发 ”介绍 了 在 Spring 开发 中 一 个 令 人 兴奋 且 能 够 改变 游戏 规则 的 
项 目 。 在 典型 的 Spring 应 用 中 ， 会 有 很 多 繁杂 的 样板 式 配 置 ， 在 这 一 章 
将 会 看 到 Spring Boot 如 何 移 除 这 些 配置 ， 能 够 让 我 们 关注 于 业务 功能 的 
实现 。 


























第 15 彰 ”使 用 远程 服务 
本 章 内 容 : 


。 访问 和 发 布 RMI 服 务 

。 使 用 Hessian 和 Burlap 服 务 

。 使 用 Spring 的 HTTP invoker 
。 使 用 Spring 开发 Web 服 务 


想象 一 下 ， 我 们 被 困 在 一 个 苑 党 的 小 咏 上 ， 这 昕 上 去 就 像 古 一 场 梦 境 变 
成 了 现实 。 毕 竞 ， 谁 不 想 在 海滩 上 静 静 地 独处 ， 可 以 幸福 地 不 顾 外 面世 
界 的 纷纷 扰 扰 呢 ? 


但 是 在 一 个 殉 号 上， 我 们 不 可 能 总 是 享受 冰镇 果汁 朗 姆 酒 和 日 光 浴 ， 就 
算 我 们 能 孕 受 这 样 宁静 的 隐居 生活 ， 但 是 过 不 了 多 入 我 们 就 会 感到 饥 
饿 、 厌 烦 和 孤独 。 在 这 样 的 时 区 里 ， 我 们 只 能 以 椰子 和 用 又 子 所 捕 的 鱼 
为 生 。 我 们 终究 还 是 需要 食物 、 新 的 衣服 以 及 其 他 供给 。 而 且 如 果 不 能 
和 其 他 人 取得 联系 ， 不 久 我 们 束 只 能 和 排球 说 话 了 ! 


我 们 开发 的 很 多 应 用 就 像 被 遗 痉 的 殉 品 。 表 面 上 看 ， 它 们 好 像 能 目 给 目 
足 ， 但 实际 上 ， 它 们 可 能 还 需要 和 其 他 系统 相互 合作 ， 这 些 系统 既 包括 
组 织 内 部 的 也 包括 组 织 外 部 的 。 


例如 ， 采 购 系 统 需要 与 厂商 的 供应 链 系统 通信 ; 公司 的 人 力 资 源 系 统 可 
能 需要 集成 薪金 系统 ， 或 者 ， 攻 金 系统 需要 和 打印 、 邮 和 寄 工 资 等 外 部 系 
统 进行 通信 。 无 论 哪 种 情况 ， 我 们 的 应 用 都 需要 和 其 他 系统 进行 区 互 ， 
远程 访问 它们 的 服务 。 


作为 一 个 Java 开 发 者 ， 我 们 有 多 种 可 以 使 用 的 远程 调用 技术 ， 包 括 : 


。 远程 方法 调用 (Remote Method Invocation，RMI) ; 
。 Caucho 的 Hessian 和 Burlap; 

。 Spring 基 于 HTTP 的 远程 服务 ; 

。 使 用 JAX-RPC 和 JAX-WS 的 Web Service。 


不 管 我 们 选择 哪 种 远程 调用 技术 ，Spring 为 使 用 这 几 种 不 同 的 技术 访问 





和 创建 远程 服务 都 提供 了 广泛 的 支持 。 在 本 章 ， 我 们 将 学 习 Spring 如 何 
简化 和 完善 这 些 远程 调用 服务 。 但 是 首先 ， 让 我 们 先 简要 了 解 一 下 远程 
调用 是 如 何在 Spring 中 工作 的 。 


15.1 Spring 远程 调用 概览 


远程 调用 是 客户 端 应 用 和 服务 端 之 间 的 会 话 。 在 客户 端 ， 它 所 需要 的 一 
些 功 能 并 不 在 该 应 用 的 实现 范围 之 内 ， 所 以 应 用 要 问 能 提供 这 些 功能 的 
其 他 系统 寻求 帮助 。 而 远程 应 用 通过 远程 服务 暴露 这 些 功能 。 


假设 我 们 想 把 Spittr 应 用 中 的 某 些 功能 发 布 为 远程 服务 并 提供 给 其 他 应 
用 来 使 用 。 或 许 除了 现 有 的 基于 浏览 器 的 用 户 界 面 ， 我 们 还 想 为 Spittr 
应 用 提供 昌 面 应 用 或 移动 端 应 用 ， 如 图 15.1 所 示 。 为 了 实现 此 想法 ， 我 
们 需要 把 SpitterService 接 口 的 基本 功能 发 布 为 远程 服务 。 


Spittr 


| | 

| | 

I I 

客户 端 Spitter 
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| 

| 



































图 15.1 第 三 方 客户 端 能 够 远程 调用 Spittr 的 服务 ， 从 而 实现 与 Spittr 应 用 交互 


其 他 应 用 与 Spittr 之 间 的 会 话 开始 于 客户 端 应 用 的 一 个 远程 过 程 调用 
(remote procedure call，RPC) 。 从 表面 上 看 ，RPC 类 似 于 调用 一 个 本 
地 对 象 的 一 个 方法 。 这 两 者 都 是 同步 操作 ， 会 阻 奢 调用 代码 的 执行 ， 直 

到 被 调用 的 过 程 执行 完毕 。 


它们 的 兰 别 仅仅 是 距离 的 问题 ， 类 似 于 人 与 人 之 间 的 交流 。 如 果 我 们 在 
公共 场所 的 饮水 机 旁 讨论 周末 足球 比赛 的 结果 ， 那 我 们 就 是 在 进行 一 个 
本 地 会 话 一 一 两 人 之 间 的 会 话 肥 生 在 同一 房间 内 。 同 样 ， 本 地 方法 调用 
古 指 同 一 个 应 用 中 的 两 个 代码 块 之 间 的 执行 流 交 换 。 


男 一 方面 ， 如 果 我 们 拿 起 电话 打 给 男 一 个 城市 的 客户 痢 ， 那 我 们 之 间 的 
会 话 就 是 通过 电话 网 络 远程 进行 的 。 类 似 地 ，RPC 调 用 就 是 执行 流 从 一 
个 应 用 传递 给 男 一 个 应 用 ， 理 论 上 男 一 个 应 用 部 署 在 跨 网 络 的 一 台 远 程 
机 器 上。 


正如 我 之 前 所 述 ，Spring 文 持 多 种 不 同 的 RPC 模 型 ， 包 括 RMI、Caucho 
的 Hessian 和 Burlap 以 及 Spring 目 带 的 HITP invoker。 表 15.1 概 述 了 每 一 个 
RPC 模 型 ， 并 简要 讨论 了 它们 所 适用 的 不 同 场 景 。 























表 15.1 Spring 通 过 多 种 远程 调用 技术 支持 RPC 























RPC 模 型 











i 不 考虑 网 络 限 制 时 (例如 防火 墙 ， 访 问 /发 布 基于 Java 的 服务 











考虑 网 络 限制 时 ， 通 过 HTTP 访 问 /发 布 基于 Java 的 服务 。Hessian 是 二 
进 制 协议 ， 而 Burlap 是 基于 XML 的 




















考虑 网 络 限制 ， 并 希望 使 用 基于 XML 或 专 有 的 序列 化 机 制 实现 Java 
HIIE invoker | 序列 化 时 ， 访 问 / 发 布 基于 Spring 的 服务 





JAX-RPC 和 


JAX-WS 访问 /发 布 平台 独立 的 、 基 于 SOAP 的 Web 服 务 








不 管 你 选择 哪 种 远程 调用 模型 ， 我 们 会 发 现 Spring 都 提供 了 风格 一 致 的 
文 持 。 这 意味 着 一 旦 理解 了 如 何 配置 Spring 来 使 用 其 中 的 一 种 模型 ， 如 
果 我 们 决定 使 用 另外 一 种 模型 的 话 ， 将 拥有 非常 低 的 学 习 曲 线 。 


在 所 有 的 模型 中 ， 服 务 都 作为 Spring 所 管理 的 bean 配 置 到 我 们 的 应 用 
中 。 这 是 通过 一 个 代理 工厂 bean 实 现 的 ， 这 个 bean 能 够 把 远程 服务 像 本 
人 样 装配 到 其 他 bean 的 属性 中 去 。 图 15.2 展 示 了 它 是 如 何 工作 
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图 15.2 ”在 Spring 中 ， 远 程 服 务 被 代理 ， 所 以 它们 能 够 像 
Spring bean 一 样 被 装配 到 客户 端 代码 中 











客户 端 向 代理 发 起 调用 ， 残 像 代 理 提供 了 这 些 服 务 一 样 。 代 理 代 表 客 户 
端 与 远程 服务 进行 通信 ， 由 它 猴 责 处 理 连接 的 细 市 并 同 远 程 服务 及 起 调 
用 5 


更 重要 的 是 ， 如 果 调 用 远程 服务 时 发 生 java.rmi .RemoteException 异 
第 ， 代 理会 处 理 此 异 利 并 重新 抛 出 非 检查 型 异 

第 RemoteAccessException。 远 程 异 常 通常 预示 着 系统 发 生 了 无 法 优 
雅 恢 复 的 问题 ， 如 网 络 或 配置 问题 。 既 然 客 户 端 通常 无 法 从 远程 异常 中 
恢复 ， 那 么 重新 抛 出 RemoteAccessException 异 常 就 能 让 客户 端 来 决 
定 是 否 处 理 此 异常 。 


在 服务 器 端 ， 我 们 可 以 使 用 表 15.1 所 列 出 的 任意 一 种 模型 将 Spring 管理 
的 bean 发 布 为 远程 服务 。 图 15.3 展 示 了 远程 导出 器 (remote exporter) 如 
何 将 bean 方 法 发 布 为 远程 服务 。 


















处 理 远 程 方法 调用 
的 编排 和 解 排 


















图 15.3 ”使 用 远程 导出 器 将 Spring 管理 的 bean 发 布 为 远程 服务 


无 论 我 们 开发 的 是 使 用 远程 服务 的 代码 ， 还 是 实现 这 些 服务 的 代码 ， 或 
者 两 者 兼 而 有 之 ， 在 Spring 中 ， 使 用 远程 服务 纯粹 是 一 个 配置 问题 。 我 
们 不 需要 编写 任何 Java 代 码 束 可 以 文 持 远程 调用 。 我 们 的 服务 bean 也 不 
需要 关心 它们 是 否 参 与 了 一 个 RPC (当然 ， 任 何 传递 给 远程 调用 的 bean 
或 从 远程 调用 返回 的 bean 可 能 需要 实现 java.io.Serializable 接 

口 ) 。 

















让 我 们 通过 RMI 
远程 调用 的 支持 吧 。 


Java 最 初 的 远程 调用 技术 一 来 开始 探索 Spring 对 





15.2 ”使 用 RMI 


如 采 你 已 经 使 用 Java 编 程 有 些 年 头 的 话 ， 你 肯定 会 听 说 过 《也 可 能 使 用 
过 ) RMI。RMI 最 初 在 JDK 1.1 被 引入 到 Java 平 台中 ， 它 为 Java 开 发 者 提 
供 了 一 种 强大 的 方法 来 实现 Java 程 序 间 的 交互 。 在 RMI 之 前 ， 对 于 Java 
开发 者 来 说 ， 远 程 调 用 的 唯一 选择 就 是 CORBA 在 当时 ， 需 要 购买 一 
种 第 三 方 产品 ， 叫 作 Object Request Broker[ORB]) ， 或 者 手工 编写 
Socket 程 序 。 


但 是 开发 和 访问 RMI 服 务 是 非 营 乏味 无 聊 的 ， 它 涉及 到 好 几 个 步骤 ， 包 
括 程序 的 和 手工 的 。Spring 简 化 了 RMI 模 型 ， 它 提供 了 一 个 代理 工厂 
bean， 能 让 我 们 把 RMI 服 务 像 本 地 JavaBean 那 样 装配 到 我 们 的 Spring 应 
用 中 。Spring 还 提供 了 一 个 远程 导出 器 ， 用 来 简化 把 Spring 管理 的 bean 
转换 为 RMI 服 务 的 工作 。 


对 于 Spittr 应 用 ， 我 们 将 展示 如 何 把 一 个 RMI 服 务 装配 进 客户 端 应 用 程序 
的 Spring 应 用 上 下 文中 。 但 首先 ， 让 我 们 看 看 如 何 使 用 RMI 导 出 器 把 
SpitterService 的 实现 发 布 为 RMI 服 务 。 








15.2.1 ”导出 RMI 服 务 
如 果 你 曾经 创建 过 RMI 服 务 ， 应 该 会 知道 这 会 涉及 如 下 几 个 步 又 : 


1. 编写 一 个 服务 实现 类 ， 类 中 的 方法 必须 抛 出 
java.rmi.RemoteException 异 节 ; 


2. 创建 一 个 继承 于 java.rmi.Remote 的 服务 接口 ; 

3. 运行 RMI 编 译 器 〈rmic) ， 创 建 客 户 端 stub 类 和 服务 端 skeleton 类 ; 
4. 局 动 一 个 RMI 注 册 表 ， 以 便 持 有 这 些 服务 ; 

5. 在 RMI 注 册 表 中 注册 服务 。 

哇 ! 发 布 一 个 简单 的 RMI 服 务 需 要 做 这 么 多 的 工作 。 除 了 这 些 必需 的 步 


骤 外 ， 你 可 能 注意 到 了 ， 会 抛 出 相当 多 的 RemoteException 和 
MalformedURLException 异 常 。 昌 然 这 些 异 常 通常 意味 着 一 个 无 法 从 











catch 人 代码 块 中 恢复 的 致命 错误 ， 但 是 我 们 仍然 需要 编写 样板 式 的 代码 
来 捕获 并 处 理 这 些 异 常 一 一 即使 我 们 不 能 修复 它们 。 


很 明显 ， 发 布 一 个 RMI 服 务 涉 及 到 大 量 的 代码 和 手工 作业 。Spring 和 古人 否 
能 够 做 一 些 工作 来 让 这 些 事情 变 得 不 再 那么 环 手 呢 ? 


在 Spring 中 配置 RMII 服 务 


幸运 的 是 ，Spring 提 供 了 更 简单 的 方式 来 发 布 RMI 服 务 ， 不 用 再 编写 那 
些 需 要 抛 出 RemoteException 异 常 的 特定 RMI 类 ， 只 需 简单 地 编写 实现 
服务 功能 的 POJO 就 可 以 了 ，Spring 会 处 理 剩余 的 其 他 事项 。 


我 们 将 要 创建 的 RMI 服 务 需 要 发 布 SpitterService 接 口中 的 方法 ， 如 
下 的 程序 清单 展现 了 该 接口 定义 。 


程序 清单 15.1 SpitterService 定 义 了 Spittr 应 用 的 服务 层 


package com.habuma.spittr.service; 
import java.util.List; 
import com.habuma.spittr.domain.Spitter; 
import com.habuma.spittr.domain.Spittle; 
public interface SpitterService { 
List<Spittle> getRecentSpittles(int count); 
void saveSpittle(Spittle spittle); 
void saveSpitter(Spitter spitter); 
Spitter getSpitter(long id); 
void startFollowing(Spitter follower, Spitter followee); 
List<Spittle> getSpittlesForSpitter(Spitter spitter); 
List<Spittle> getSpittlesForSpitter(String username ) ; 


Spitter getSpitter(String username ) ; 
Spittle getSpittleById(long id); 
void deleteSpittle(long id); 
List<Spitter> getAllSpitters(); 





如 果 我 们 使 用 传统 的 RMI 来 发 布 此 服务 ，SpitterService 和 
SpitterServiceImpl 中 的 所 有 方法 都 需要 抛 出 
java.rmi.RemoteException。 但 是 如 果 我 们 使 用 Spring 的 
RmiServiceExporter 把 该 类 转变 为 RMI 服 务 ， 那 现 有 的 实现 不 需要 做 
任何 改变 。 


RmiServiceExporter 可 以 把 任意 Spring 管理 的 bean 发 布 为 RMI 服 务 。 
如 图 15.4 所 示 ，RmiServiceExporter 把 bean 包 装 在 一 个 适配器 类 中 ， 
然后 适配器 类 被 绑 定 到 RMI 注 册 表 中 ， 并 且 代 理 到 服务 类 的 请 求 一 一 在 
本 例 中 服务 类 也 就 是 spitterServiceImpl。 


| RmiServiceExporter 
创建 


RMI 服 务 适 配器 


SpitterServicelmpl 


图 15.4 ”RmiServiceExporter 把 POJO 包 装 到 服务 适配器 中 ， 并 将 服务 适配器 绑 定 到 RMI 注 册 表 
中 ， 从 而 将 POJO 转 换 为 RMI 服 务 

















使 用 RmiSserviceExporter 将 SpitterServiceImp1 发 布 为 RMI 服 务 的 
最 简单 方式 是 在 Spring 中 使 用 如 下 的 @Bean 方 法 进行 配置 : 





@Bean 

public RmiServiceExporter rmiExporter(SpitterService spitterService) { 
RmiServiceExporter rmiExporter = new RmiServiceExporter(); 
rmiExporter.setService(spitterService); 


rmiExporter.setServiceName("SpitterService"); 
rmiExporter.setServiceInterface(SpitterService.class); 
return rmiExporter; 





这 里 会 把 spitterServicebean 设 置 到 service 属 性 中 ， 表 

明 RmiserviceExporter 要 把 该 bean 发 布 为 一 个 RMI 服 

务 。serviceName 属 性 命名 了 RMI 服 务 ，serviceInterface 属 性 指定 
了 此 服务 所 实现 的 接口 。 


默认 情况 下 ，RmiserviceExporter 会 尝试 绑 定 到 本 地 机 器 1099 端 口上 
的 RMI 注 册 表 。 如 宋 在 这 个 问 口 没有 发 现 RMI 注 册 

表 ，RmiServiceExporter 将 会 启动 一 个 注册 表 。 如 果 和 希望 绑 定 到 不 同 
端口 或 主机 上 的 RMI 注 册 表 ， 那 么 我 们 可 以 通过 registryPort 和 
registryHost 属 性 来 指定 。 例 如 ， 下 面 的 RmiServiceExporter 会 尝 


试 绑 定 rmi.spitter.com 主 机 1199 端 口上 的 RMI 注 册 表 : 


@Bean 

public RmiServiceExporter rmiExporter(SpitterService spitterService) { 
RmiServiceExporter rmiExporter = new RmiServiceExporter(); 
rmiExporter.setService(spitterService); 
rmiExporter.setServiceName("SpitterService"); 


rmiExporter.setServiceInterface(SpitterService.class); 
rmiExporter.setRegistryHost("rmi.spitter.com"); 
rmiExporter.setRegistryPort(1199); 

return rmiExporter; 





这 就 是 我 们 使 用 Spring 把 某 个 bean 转 变 为 RMI 服 务 所 需要 做 的 全 部 工 
作 。 现 在 Spitter 服 务 已 经 导出 为 RMI 服 务 ， 我 们 可 以 为 Spittr 应 用 创建 其 
他 的 用 户 界 面 或 洲 请 第 三 方 使 用 此 RMI 服 务 创建 新 的 客户 端 。 如 果 使 用 
Spring， 客 户 端 开发 者 访问 Spitter 的 RMI 服 务 会 非常 容易 。 


让 我 们 转换 一 下 视角 来 看 看 如 何 编写 Spitter RMI 服 务 的 客户 端 。 
15.2.2 ”装配 RMI 服 务 


传统 上 ，RMI 客 户 端 必须 使 用 RMI API 的 Naming 类 从 RMI 注 册 表 中 查找 
服务 。 例 如 ， 下 面 的 代码 片段 演示 了 如 何 获 取 Spitter 的 RMI 服 务 : 


try { 
String serviceUrl = "rmi:/spitter/SpitterService"; 
SpitterService spitterService = 
(SpitterService) Naming.lookup(serviceUr]); 


} 

catch (RemoteException e) { ... } 

catch (NotBoundException e) { ... } 
catch (MalformedURLException e) { ... } 








虽然 这 段 代 码 可 以 获取 Spitter 的 RMI 服 务 的 引用 ， 但 是 它 存在 两 个 问 


题 : 


。 传统 的 RMI 碍 找 可 能 会 导致 3 种 检查 型 异常 的 任意 一 种 


(RemoteException、NotBoundException 和 和 
MalformedURLException) ， 这 些 异 党 必须 被 捕获 或 重新 抛 出 ; 








。 需要 Spitter 服 务 的 任何 代码 都 必须 自己 负责 获取 该 服务 。 这 属于 样 
板 代 码 ， 与 客户 端的 功能 并 没有 直接 关系 。 


RMI 碍 找 过 程 中 所 抛 出 的 异 冲 通 钊 意味 着 应 用 发 生 了 致命 的 不 可 恢复 的 
问题 。 例 如 ，MalformedURLException 异 常 意味 着 这 个 服务 的 地 址 是 
无 效 的。 为 了 从 这 个 弄 常 中 恢复 ， 应 用 至 少 要 重新 配置 ， 也 可 能 需要 重 
新 编译 。try/catch 代 码 块 并 不 能 在 发 生 异 常 时 优雅 地 恢复 ， 既 然 如 

此 ， 为 什么 还 要 强制 我 们 的 代码 捕获 并 处 理 这 个 异 冲 呢 ? 


但 是 ， 更 糟糕 的 事情 是 这 段 代 码 直接 违反 了 依赖 注入 〈DI) 原则 。 因 为 
客户 端 代 但 需要 负责 碍 找 Spitter 服 务 ， 并 且 这 个 服务 是 RMI 服 务 ， 我 们 
甚至 没有 任何 机 会 去 提供 SpitterService 对 象 的 不 同 实现 。 理 想 情 况 
下 ， 应 该 可 以 为 任意 一 个 bean 注 入 SpitterService 对 象 ， 而 不 是 让 
bean 自 己 去 查找 服务 。 利 用 DI，SpitterService 的 任何 客户 端 都 不 需 
要 关心 此 服务 来 源 于 何 处 。 


Spring 的 RmiProxyFactoryBean 是 一 个 工厂 bean， 该 bean 可 以 为 RMI 服 
务 创建 代理 。 使 用 RmiProxyFactoryBean 引 用 SpitterService 的 RMI 
服务 是 非常 简单 的 ， 只 需要 在 客户 端的 Spring 配置 中 增加 如 下 的 @Bean 
方法 : 











@Bean 
public RmiproxyFactoryBean spitterService() { 
RmiproxyFactoryBean rmiproxy = new RmiproxyFactoryBean(); 


rmiproxy.setServiceUrl("rmi://localhost/SpitterService"); 
rmiproxy.setServiceInterface(SpitterService.class); 
return rmiproxy; 





服务 的 URL 是 通过 RmiProxyFactoryBean 的 serviceUr1l 属 性 来 设置 

的 ， 在 这 里 ， 服 务 名 被 设置 为 SpitterService， 并 且 声 明 服 务 是 在 本 
地 机 器 上 的 ， 同 时 ， 服 务 提供 的 接口 由 serviceInterface 属 性 来 指 

定 。 图 15.5 展 示 了 客户 端 和 RMI 代 理 的 交互 。 





RmiProxy 
FactoryBean 
Spitter 
生成 服务 


Rl - 
代理 Impl 


图 15.5 ”RmiProxyFactoryBean 生 成 一 个 代理 对 象 ， 该 对 象 代表 客户 端 来 负责 与 远程 的 RMI 服 务 
进行 通信 。 客 户 端 通过 服务 的 接口 与 代理 进行 交互 ， 就 如 同 远 程 服务 就 是 一 个 本 地 的 POJO 


方法 调用 


SpitterService 
























































现在 已 经 把 RMI 服 务 声明 为 Spring 管 理 的 bean， 我 们 就 可 以 把 它 作 为 依 
赖 装配 进 男 一 个 bean 中 ， 就 像 任意 非 远 程 的 bean 那 样 。 例 如 ， 假 设 客 户 
问 需 要 使 用 Spitter 服 务 为 指定 的 用 户 获 取 Spitt1le 列 表 ， 我 们 可 以 使 
用 Q@Autowired 注 解 把 服务 代理 装配 进 客户 端 中 : 


@Autowired 
SpitterService spitterService; 





我 们 还 可 以 像 本 地 bean 一 样 调用 它 的 方法 : 


public List<Spittle> getSpittles(String userName) { 
Spitter spitter = spitterService.getSpitter(userName); 


return spitterService.getSpittlesForSpitter(spitter); 
} 


以 这 种 方式 访问 RMI 服 务 简 直 太 棒 了 ! 客户 端 代码 甚至 不 需要 知道 所 处 
理 的 是 一 个 RMI 服 务 。 它 只 是 通过 注入 机 制 接受 了 一 

个 SpitterService 对 象 ， 根 本 不 必 关 心 它 来 自 何 处 。 实 际 上 ， 谁 知道 
客户 疹 得 到 的 惑 是 一 个 基于 RMI 的 实现 呢 ? 


此 外 ， 代 理 捕获 了 这 个 服务 所 有 可 能 抛 出 的 RemoteException 异 常 ， 
并 把 它 包装 为 运行 期 异常 重新 抛 出 ， 这 样 我 们 就 可 以 放心 地 忽略 这 些 异 
常 。 我 们 也 可 以 非常 容易 地 把 远程 服务 bean 蔡 换 为 该 服务 的 其 他 实现 
或 许 是 不 同 的 远程 服务 ， 或 者 可 能 是 客户 端 代 码 单 元 测试 时 的 一 个 
mock 实 现 。 

















虽然 客户 端 代码 根本 不 需要 关心 所 赋予 的 SpitterService 是 一 个 远程 
服务 ， 但 我 们 需要 非常 谨慎 地 设计 远程 服务 的 接口 。 提 醒 一 下 ， 客 户 端 
不 得 不 调用 两 次 服务 : 一 次 是 根据 用 户 名 查找 Spitter， 另 一 次 是 获取 
Spittle 对 象 的 列表 。 这 两 次 远程 调用 都 会 受 网 络 延迟 的 有 影响， 进而 可 
能 会 影响 到 客户 端的 性 能 。 清 楚 了 客户 端 是 如 何 使 用 服务 的 ， 我 们 或 许 
9 把 这 两 个 调用 放 进 一 个 方法 中 。 但 是 现在 我 们 要 接受 这 样 
， 雪上 | 。 


RMI 是 一 种 实现 远程 服务 交互 的 好 办 法 ， 但 是 它 存 在 某 些 限制 。 首 先 ， 
RMI 很 难 穿 越 防 火 墙 ， 这 是 因为 RMI 使 用 任意 端口 来 交互 一 一 这 是 防火 
墙 通常 所 不 允许 的 。 在 企业 内 部 网 络 环 境 中 ， 我 们 通常 不 需要 担心 这 个 
问题 。 但 是 如 果 在 互联 网 上 运行 ， 我 们 用 RMI 可 能 会 遇 到 麻烦 。 即 使 
RMI 提 供 了 对 HTTP 的 通道 的 支持 (通常 防火 墙 都 允许 ) ， 但 是 建立 这 
个 通道 也 不 是 件 容 易 的 事 。 


另外 一 件 需要 考 忽 的 事情 是 RMI 是 基于 Java 的 。 这 意味 着 客户 端 和 服务 
端 必 须 都 是 用 Java 开 发 的 。 因 为 RMI 使 用 了 Java 的 序列 化 机 制 ， 所 以 通 

过 网 络 传输 的 对 象 类 型 必须 要 保证 在 调用 两 端的 Java 运 行 时 中 是 完全 相 
同 的 版 本 。 对 我 们 的 应 用 而 言 ， 这 可 能 是 个 问题 ， 也 可 能 不 是 问题 。 但 
是 选择 RMI 做 远程 服务 时 ， 必 须要 牢记 这 一 点 。 


Caucho Technology (Resin 应 用 服务 器 背后 的 公司 〉 开 发 了 一 套 应 对 
RMI 限 制 的 远程 调用 解决 方案 。 实 际 上 ，Caucho 提 供 了 两 种 解决 方案 : 
Hessian 和 Burlap。 让 我 们 看 一 下 如 何在 Spring 中 使 用 Hessian 和 Burlap 处 
理 远 程 服 务 。 

















15.3 ”使 用 Hessian 和 Burlap 发 布 远 程 服 务 


Hessian 和 Burlap 是 Caucho Technology 提 供 的 两 种 基于 HTTP 的 轻 量 级 远 
程 服务 解决 方案 。 借 助 于 尽 可 能 简单 的 API 和 通信 协议 ， 它 们 都 致力 于 
简化 Web 服 务 。 


你 可 能 会 好 奇 ， 为 什么 Caucho 对 同一 个 问题 会 有 两 种 解决 方案 。 
Hessian 和 Burlap 束 如 同一 个 事物 的 两 面 ， 但 是 每 一 个 解决 方案 都 服务 于 
上 略微 不 同 的 目的 。 


Hessian， 像 RMI 一 样 ， 使 用 二 进 制 消息 进行 客户 端 和 服务 端的 交互 。 但 
与 其 他 二 进 制 远 程 调用 技术 (例如 RMI) 不 同 的 是 ， 它 的 二 进 制 消息 可 
以 移植 到 其 他 非 Java 的 语言 中 ， 包 括 PHP、Python、C++ 和 C#。 


Burlap 是 一 种 基于 XML 的 远程 调用 技术 ， 这 使 得 它 可 以 自然 而 然 地 移植 
到 任何 能 够 解析 XML 的 语言 上 。 正 因为 它 基 于 XML， 所 以 相 比 起 
Hessian 的 二 进 制 格 式 而 言 ，Burlap 可 读 性 更 强 。 但 是 和 其 他 基于 XML 的 
远程 技术 《〈 例 如 SOAP 或 XML-RPC) 不 同 ，Burlap 的 消息 结构 尽 可 能 的 
简单 ， 不 需要 额外 的 外 部 定义 语言 〈 例 如 WSDL 或 IDL ) 。 


你 可 能 想 知 道 如 何在 Hessian 和 Burlap 之 间 做 出 选择 。 很 大 程度 上 上， 它们 
是 一 样 的 。 唯 一 的 区 别 在 于 Hessian 的 消息 是 二 进 制 的， 而 Burlap 的 消息 
是 XML 。 由 于 Hessian 的 消息 是 二 进 制 的 ， 所 以 它 在 带宽 上 更 具 优 势 。 
但 是 如 果 我 们 更 注重 可 读 性 〈 如 出 于 调试 的 目的 ) 或 者 我 们 的 应 用 需要 
那么 Burlap 的 XML 消息 会 是 更 好 的 选 
到 

举 。 


为 了 在 Spring 中 演示 Hessian 和 Burlap 服 务 ， 让 我 们 回顾 一 下 在 前 一 节 中 
使 用 RMI 解 决 Spitter 服 务 的 示例 。 但 是 这 一 次 ， 我 们 将 看 看 如 何 使 用 
Hessian 和 Burlap 作 为 远程 调用 模型 来 解决 这 个 问题 。 








15.3.1 使 用 Hessian 和 Burlap 导 出 bean 的 功能 


像 之 前 一 样 ， 我 们 希望 把 SpitterServiceImpl 类 的 功能 发 布 为 远程 服务 
这 次 是 一 个 Hessian 服 务 。 即 使 没有 Spring， 编 写 一 个 Hessian 服 务 也 
是 相当 容易 的 。 我 们 只 需要 编写 一 个 继 





承 com.caucho.hessian.server.HessianServlet 的 类 ， 并 确保 所 有 
的 服务 方法 是 public 的 (在 Hessian 里 ， 所 有 public 方 法 被 视 为 服务 方 
法 ) 。 


为 Hessian 服 务 很 容易 实现 ，Spring 并 没有 做 更 多 简化 Hessian 模 型 的 工 
人 。 但 是 和 Spring 一 起 使 用 时 ，Hessian 服 务 可 以 在 各 方面 利用 Spring 框 

架 的 优势 ， 这 是 纯 Hessian 服 务 所 不 具备 的 。 包 括 利 用 Spring 的 AOP 来 为 
Hessia 服务 提供 系统 级 服务 ， 例 如 声明 式 事务 。 


导出 Hessian 服 务 


在 Spring 中 导出 一 个 Hessian 服 务 和 在 Spring 中 实现 一 个 RMI 服 务 怀 人 的 
相似 。 为 了 把 Spitter 服 务 bean 发 布 为 RMI 服 务 ， 我 们 需要 在 Spring 配置 文 
件 中 配置 一 个 RmiServiceExporterbean。 同 样 的 方式 ， 为 了 把 Spitter 
服务 发 布 为 Hessian 服 务 ， 我 们 需要 配置 另 一 个 导出 bean， 只 不 过 这 次 


是 HessianServiceExporter。 


HessianServiceExporter 对 Hessian 服 务 所 执行 的 功能 

与 RmiServiceExporter 对 RMI 服 务 所 执行 的 功能 是 相同 的 : i 
的 public 方 法 发 布 成 Hessian 服 务 的 方法 。 不 过 ， 正 如 图 15.6 所 示 ， 其 实 

现 过 程 与 RmiSserviceExporter 将 POJO 发 布 为 RMI 服 务 是 不 同 的 。 
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请 求 Servlet 分 发 Exporter 
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图 15.6 HessianServiceExporter 是 一 个 Spring MVC 控 制 器 ， 它 可 以 接收 Hessian 请 求 ， 并 把 这 些 


























请 求 转 换 成 对 POJO 的 调用 从 而 将 POJO 导 出 为 一 个 Hessian 服 务 




















HessianServiceExporter《〈 稍 后 会 有 更 详细 的 介绍 ) 是 一 个 Spring 
MVC 控 制 嚣 ， 它 接收 Hessian 请 求 ， 并 将 这 些 请 求 转换 成 对 被 导出 POJO 
的 方法 调用 。 在 如 下 Spring 的 声明 中 ，HessianServiceExporter 会 把 
spitterService bean 导 出 为 Hessian 服 务 : 


@Bean 
public HessianServiceExporter 
hessianExportedSpitterService(SpitterService service) { 
HessianServiceExporter exporter = new HessianServiceExporter(); 


exporter.setService(service); 
exporter.setServiceInterface(SpitterService.class); 
return exporter; 





正如 RmiServiceExporter 一 样 ，service 属 性 的 值 被 设置 为 实现 了 这 
个 服务 的 bean 引 用 。 在 这 里 ， 它 引用 的 

是 spitterServicebean。serviceInterface 属 性 用 来 标识 这 个 服务 
实现 了 SpitterService 接 口 。 





与 RmiServiceExporter 不 同 的 是 ， 我 们 不 需要 设置 serviceName 属 
性 。 在 RMI 中 ，serviceName 属 性 用 来 在 RMI 注 册 表 中 注册 一 个 服务 。 
而 Hessian 没 有 注册 表 ， 因 此 也 就 没 必要 为 Hessian 服 务 进 行 命名 。 


配置 Hessian 控 制 器 


RmiServiceExporter 和 HessianServiceExporter 男 外 一 个 主要 区 别 就 
是 ， 由 于 Hessian 是 基于 HTTP 的 ， 所 以 HessianSeriviceExporter 实 
现 为 一 个 Spring MVC 控 制 右 。 这 意味 着 为 了 使 用 导出 的 Hessian 服 务 ， 
我 们 需要 执行 两 个 额外 的 配置 步 又 ; 


。 在 web.xml 中 配置 Spring 的 DispatcherServlet， 并 把 我 们 的 应 用 
部 署 为 ” Web 应用; 

。 在 Spring 的 配置 文件 中 配置 一 个 URL 处 理 器 ， 把 Hessian 服 务 的 URL 
分 发 给 对 应 的 Hessian 服 务 bean。 


我 们 在 第 5 章 学 习 了 如 何 配 置 Spring 的 DispatcherServlet 和 和 URL 处理 
器 ， 所 以 这 些 步骤 看 起 来 有 些 熟 悉 。 首 先 ， 我 们 需要 一 

个 DispatcherServlet。 还 好 ， 这 个 我 们 已 经 在 Spittr 应 用 的 web.xml 文 
件 中 配置 了 。 但 是 为 了 人 处理 Hessian 服 务 ，DispatcherServlet 还 需要 
配置 一 个 Servlet 映 射 来 拦截 后 缀 为 “*.service” 的 URL: 








<servlet-mapping> 
<servlet-name>spitter</servlet-name> 


<url-pattern>*.service</url-pattern> 
</servlet-mapping> 





如 果 你 在 Java 中 通过 实现 WebApplicationInitializer 来 配 

置 DispatcherServlet 的 话 ， 那 么 需要 将 URL 模 式 作 为 映射 添加 

到 ServletRegistration.Dynamic 中 ， 在 将 DispatcherServlet 添 加 
到 容器 中 的 时 候 ， 我 们 能 够 得 到 ServletRegistration.Dynamic 对 
象 : 


ServletRegistration.Dynamic dispatcher = container.addServlet( 
"appServlet", new DispatcherServlet(dispatcherServletContext)); 


dispatcher.setLoadonStartup(1); 
dispatcher.addMapping("/"); 
dispatcher.addMapping("*.service"); 





或 者 ， 如 果 你 通过 扩展 AbstractDispatcherServletInitializer 
或 Abstract-AnnotationConfigDispatcherServletInitializer 的 
方式 来 配置 DispatcherServlet， 那 么 在 重 

载 getServletMappings() 的 时 候 ， 需 要 包含 该 映射 : 


@Override 
protected String[] getServletMappings() { 


return new String[] { "/", "*.service" }; 


} 





这 样 配置 后 ， 任 何以 “.service” 结 束 的 URL 请 求 都 将 

由 DispatcherServlet 处 理 ， 它 会 把 请 求 传递 给 匹配 这 个 URL 的 控制 
器 。 因 此 “spitter.service” 的 请 求 最 终 将 被 hessianSpitterServicebean 
所 处 理 〈 它 实际 上 仅仅 是 一 个 SpitterServiceImp1 的 代理 ) 。 


那 我 们 是 如 何 知道 这 个 请 求 会 转 给 hessianSspitterSevice 处 理 呢 ? 我 
们 还 需要 配置 一 个 URL 了 映射 来 确保 DispatcherServlet 把 请 求 转 给 
hessianSpitterService。 如 下 的 SimpleUrLIHandlerMappingbean 可 
以 做 到 这 一 点 : 





@Bean 

public HandlerMapping hessianMapping() { 
SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping(); 
Properties mappings = new Properties(); 
mappings.setproperty("/spitter.service", 

"hessianExportedSpitterService"); 

mapping.setMappings (mappings); 
return mapping; 


如 果 不 喜 欢 Hessian 的 二 进 制 协议 ， 我 们 还 可 以 选择 使 用 Burlap 基 于 XML 
的 协议 。 让 我 们 看 看 如 何 把 一 个 服务 导出 为 Burlap 服 务 。 


导出 Burlap 服 务 


从 任何 方面 上 看 ，BurlapServiceExporter 

与 HessianServiceExporter 实 际 上 都 是 相同 的 ， 只 不 过 它 使 用 基于 
XML 的 协议 而 不 是 二 进 制 协议 。 下 面 的 bean 定 义 展 示 了 如 何 使 

用 BurlapServiceExporter 把 Spitter 服 务 导 出 为 一 个 Burlap 服 务 : 


@Bean 
public BurlapServiceExporter 
burlapExportedSpitterService(SpitterService service) { 
BurlapServiceExporter exporter = new BurlapServiceExporter(); 


exporter.setService(service); 
exporter.setServiceInterface(SpitterService.class); 
return exporter; 





正如 我 们 所 看 到 的 ， 这 个 bean 与 使 用 Hessian 所 对 应 bean 的 唯一 区 别 在 于 
bean 的 方法 和 导出 类 。 配 置 Burlap 服 务 和 配置 Hessian 服 务 是 一 模 一 样 
的 ， 这 包括 需 要 准备 一 个 URL 处 理 器 和 一 个 DispatcherServlet。 


现在 让 我 们 看 看 会 话 的 另 一 器 ， 如 何 访问 我 们 使 用 Hessian 〈 或 Burlap) 
所 发 布 的 服务 。 








15.3.2 访问 Hessian/Burlap 服 务 


回顾 一 下 在 15.2.2 小 节 中 ， 在 使 用 RmiProxyFactoryBean 访 问 Spitter 服 
务 的 客户 端 代码 中 ， 完全 个 知道 这 个 服务 是 一 个 RMI 服 务 。 事实 上 上， 也 
A eit ee ee es ep J 

配置 中 这 个 bean 的 配置 中 。 不 需要 了 解 服务 的 实现 呈 : 
从 RMI 客 户 ? 出 转 到 Hessian 客 户 端 会 变 得 极其 简单 ， 不 需要 改变 任何 客户 
端的 Java 代 码 。 


坏处 是 ， 如 果 你 真 的 喜欢 编写 Java 代 码 的 话 ， 那 么 这 一 节 或 许 让 你 大 失 
所 望 。 这 是 因为 在 客户 端 代 码 中 ， 基 于 RMI 的 服务 与 基于 Hessian 的 服务 




















之 间 唯 一 的 差别 在 于 要 使 用 Spring 的 HessianProxyFactoryBean 来 代 
奉 RmiProxyFactoryBean。 客 户 端 调用 基于 Hessian 的 Spitter 服 务 可 以 
用 如 下 的 配置 声明 : 


@Bean 
public HessianProxyFactoryBean spitterService() { 
HessianProxyFactoryBean proxy = new HessianproxyFactoryBean(); 


proxy.setServiceUrl("http://localhost:806886/Spitter/spitter. service"); 
proxy.setServiceInterface(SpitterService.class); 
return proxy; 


} 





就 像 基 于 RMI 服 务 那样 ，serviceInterface 属 性 指定 了 这 个 服务 实现 
的 接口 。 并 且 ， 像 RmiProxyFactoryBean 一 样 ，serviceUr1 标 识 了 这 
个 服务 的 URL。 既 然 Hessian 是 基于 HTTP 的 ， 当 然 我 们 在 这 里 要 设置 一 
个 HTTP URL (URL 是 由 我 们 先前 定义 的 URL 映 射 所 决定 的 ) 。 图 15.7 
展示 了 客户 端 以 及 由 HessianProxyFactoryBean 所 生成 的 代理 之 间 是 
如 何 交 互 的 。 
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图 15.7 ”HessianProxyFactoryBean 和 BurlapProxyFactoryBean 生 成 的 代理 对 象 负责 通过 
HTTP (Hessian 为 二 进 制 、Burlap 为 XML ) 与 远程 对 象 通信 


事实 证 明 ， 把 Burlap 服 务 装配 进 客户 端 同样 也 没有 太 多 新 意 。 二 者 唯一 
的 区 别 在 于 ， 我 们 要 使 用 BurLlapProxyFactoryBean 来 代替 
HessianProxyFactoryBean: 
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@Bean 
public BurlapProxyFactoryBean spitterService() { 
BurlapProxyFactoryBean proxy = new BurlapProxyFactoryBean(); 


proxy.setServiceUrl("http://localhost:806886/Spitter/spitter. service"); 
proxy.setServiceInterface(SpitterService.class); 
return proxy; 


} 








尽管 我 们 觉得 在 RMI、Hessian 和 Burlap 服 务 之 间 稍 微 不 同 的 配置 是 很 无 
趣 的 ， 但 是 这 样 的 单调 恰恰 是 有 好 处 的 。 它 意味 着 我 们 可 以 很 容易 在 各 
种 Spring 所 文 持 的 远程 调用 技术 之 间 进 行 切 换 ， 而 不 需要 重新 学 习 一 个 
全 新 的 模型 。 一 旦 我 们 配置 了 对 RMI 服 务 的 引用 ， 把 它 重 新 配置 为 
Hessian 或 Burlap 服 务 也 是 很 轻松 的 工作 。 


为 Hessian 和 Burlap 都 是 基于 HTITP 的 ， 它 们 都 解决 了 RMI 所 头疼 的 防 
火 墙 渗透 问题 。 但 是 当 传 递 过 来 的 RPC 消 息 中 包含 序列 化 对 象 时 ，RMI 
就 完胜 Hessian 和 Burlap 了 。 因 为 Hessian 和 Burlap 都 采用 了 私有 的 序列 化 
机 制 ， 而 RMI 使 用 的 是 Java 本 时 的 序列 化 机 制 。 如 果 我 们 的 数据 模型 非 
常 复杂 ，Hessian/Burlap 的 序列 化 模型 就 可 能 无 法 胜任 了 。 


我 们 还 有 一 个 两 全 其 美的 解决 方案 。 让 我 们 看 一 下 Spring 的 HTTP 
invoker， 它 基于 HTTP 提 供 了 RPC ( 像 Hessian/Burlap 一 样 )， 同 时 又 使 
用 了 Java 的 对 象 序列 化 机 制 ( 像 RMI 一 样 〉。 








15.4 使 用 Spring 的 HttpInvoker 


Spring 开发 团队 意识 到 RMI 服 务 和 基于 HTTP 的 服务 〈 例 如 Hessian 和 
Burlap) 之 间 的 空白 。 一 方面 ，RMI 使 用 Java 标 准 的 对 象 序列 化 机 制 ， 
但 是 很 难 穿 透 防 火 墙 。 男 一 方面 ，Hessian 和 Burlap 能 很 好 地 穿 透 防火 
省 ， 但 是 使 用 私有 的 对 象 序列 化 机 制 。 


就 这 样 ，Spring 的 HTTP invoker 应 运 而 生 了 。HTTP invoker 是 一 个 新 的 
远程 调用 模型 ， 作 为 Spring 框 架 的 一 部 分 ， 能 够 执行 基于 HTTP 的 远程 调 
用 (让 防火 墙 不 为 难 ) ， 并 使 用 Java 的 序列 化 机 制 ( 让 开发 者 也 乐观 其 
变 ) 。 使 用 基于 HTTP invoker 的 服务 和 使 用 基于 Hessian/Burlap 的 服务 非 
常 相 似 。 


为 了 开始 学 习 HTTP invoker， 让 我 们 再 来 看 一 下 Spitter 服 务 一 一 这 一 次 
我 们 将 作为 HTTP invoker 服 务 来 实现 。 


15.4.1 将 bean 导 出 为 HTTP 服 务 


要 将 bean 导 出 为 RMI 服 务 ， 我 们 需要 使 用 RmiServiceExporter; 要 将 
bean 导 出 为 Hessian 服 务 ， 我 们 需要 使 用 HessianServiceExporter; 要 
将 bean 导 出 为 Burlap 服 务 ， 我 们 需要 使 用 BurlapServiceExporter。 把 
这 种 千篇一律 的 用 法 带 到 HTTP invoker 上， 应 该 也 不 会 有 任何 意外 的 事 
情 发 生 ， 那 就 是 导出 HTTP invoker 服 务 ， 我 们 需要 使 

用 HttpInvokerServiceExporter。 


为 了 把 Spitter 服 务 导出 为 一 个 基于 HTTP invoker 的 服务 ， 我 们 需要 像 下 
面 的 配置 一 样 声明 一 个 HttpInvokerServiceExporterbean: 


@Bean 
public HttpInvokerServiceExporter 
httpExportedSpitterService(SpitterService service) { 
HttpInvokerServiceExporter exporter = 


new HttpInvokerServiceExporter(); 
exporter.setService(service); 
exporter.setServiceInterface(SpitterService.class); 
return exporter; 





是 否 有 点 似曾相识 的 感 党 ?我 们 很 难 找 出 这 个 bean 的 定义 和 那些 在 
15.3.2 小 节 中 所 声明 的 bean 有 什么 不 同 。 唯 一 的 区 别 在 于 类 

名 : HttpInvokerServiceExporter。 奋 则 的 话 ， 这 个 导出 器 和 其 他 
的 远程 服务 的 导出 器 就 没有 任何 区 别 了 。 


如 图 15.8 所 示 ，HttpInvokerServiceExporter 的 工作 方式 

与 HessianService-Exporter 和 BurlapServiceExporter 很 相 

似 。HttpInvokerServiceExporter 也 是 一 个 Spring 的 MVC 控 制 器 ， 
它 通 过 DispatcherServlet 接 收 来 自 于 客户 端的 请 求 ， 并 将 这 些 请 求 


转换 成 对 实现 服务 的 POJO 的 方法 调用 。 
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图 15.8 ”HttpInvokerServiceExporter 工 作 方 式 与 Hessian 和 Burlap 很 相似 ， 
通过 Spring MVC 的 DispatcherServlet 接 收 请 求 ， 并 将 这 些 请 求 转换 成 对 Spring bean 的 方法 调用 















因为 HttpInvokerServiceExporter 是 一 个 Spring MVC 控 制 器 ， 我 们 
需要 建立 一 个 URL 处 理 器 ， 映 射 HTTP URL 到 对 应 的 服务 上 ， 就 像 
Hessian 和 Burlap 导 出 器 所 做 的 一 样 : 


@Bean 

public HandlerMapping httpInvokerMapping() { 
SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping(); 
Properties mappings = new Properties(); 


mappings.setproperty("/spitter.service", 
"httpExportedSpitterService"); 

mapping.setMappings (mappings); 

return mapping; 








同样 ， 像 之 前 一 样 ， 我 们 需要 确保 匹配 了 DispatcherServlet， 这 样 
才能 处 理 对 “*.service” 扩 展 的 请 求 。 参 考 15.3.1 小 节 了 解 如 何 设置 映射 。 


我 们 已 经 知道 如 何 访问 由 RMI、Hessian 或 Burlap 所 创建 的 远程 服务 ， 现 
在 我 们 再 次 让 Spitter 客 户 端 使 用 刚才 所 导出 的 基于 HTTP invoker 的 服 
务 。 


15.4.2 ”通过 HTTP 访 问 服务 


这 上 听 起 来 像 打 破 记 录 ， 但 是 我 还 得 告诉 你 ， 访 问 基 于 HITP invoker 的 服 
务 很 类 似 于 我 们 之 前 使 用 的 其 他 远程 服务 代理 。 实 际 上 惑 是 一 样 的 。 如 
图 15.9 所 示 ，HttpInvokerProxyFactoryBean 填 充 了 相同 的 位 置 ， 下 
如 我 们 在 本 章 所 看 到 的 其 他 远程 服务 代理 工厂 bean 一 样 。 
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图 15.9 ”HttpInvokerProxyFactoryBean 是 一 个 代理 工厂 bean， 用 于 生成 一 个 代理 ， 该 代理 使 用 
Spring 特 有 的 基于 HTTP 协 议 进 行 远程 通信 


为 了 把 基于 HTTP invoker 的 远程 服务 装配 进 我 们 的 客户 端 Spring 应 用 上 
下 文中 ， 我 们 必须 将 HttpInvokerProxyFactoryBean 配置 为 一 个 
bean 来 代理 它 ， 如 下 所 示 : 



































@Bean 

public HttpInvokerProxyFactoryBean spitterService() { 
HttpInvokerProxyFactoryBean proxy = new HttpInvokerProxyFactoryBean(); 
proxy.setServiceUrl("http://localhost:886886/Spitter/spitter. service"); 


proxy.setServiceInterface(SpitterService.class); 
return proxy; 





与 15.2.2 小 节 和 15.3.2 小 节 的 bean 定 义 相 对 比 ， 我 们 会 发 现 几乎 没什么 变 
化 。serviceInterface 属 性 仍然 用 来 标识 Spitter 服 务 所 实现 的 接口 ， 


而 serviceUrl 属 性 仍然 用 来 标识 远程 服务 的 位 置 。 因 为 HTTP invoker 
是 基于 HTTP 的 ， 如 同 Hessian 和 Burlap 一 样 ，serviceUr1 可 以 包含 与 
Hessian 和 Burlap 版 本 中 的 bean 一 样 的 URL。 


难道 你 不 喜欢 对 称 美 吗 ? 


Spring 的 HTTP invoker 是 作为 两 全 其 美的 远程 调用 解决 方案 而 出 现 的 ， 
把 HTTP 的 简单 性 和 Java 内 置 的 对 象 序 列 化 机 制 融 合 在 一 起 。 这 使 得 
HTTP invoker 服 务 成 为 一 个 引 人 注 目的 替代 RMI 或 Hessian/Burlap 的 可 选 
方案 。 


要 记 住 HTTP invoker 有 一 个 重大 的 限制 : 它 只 是 一 个 Spring 框 架 所 提供 
的 远程 调用 解决 方案 。 这 意味 着 客户 端 和 服务 端 必须 都 是 Spring 应 用 。 
并 且 ， 至 少 目前 而 言 ， 也 隐 含 表明 客户 端 和 服务 端 必 须 是 基于 Java 的 。 
另外 ， 因 为 使 用 了 Java 的 序列 化 机 制 ， 客 户 端 和 服务 端 必须 使 用 相同 版 
本 的 类 (与 RMI 类 似 )。 


RMI、Hessian、Burlap 和 HTTP invoker 都 是 远程 调用 的 可 选 解 决 方案 。 
但 是 当面 临 无 所 不 在 的 远程 调用 时 ，Web 服 务 是 势不可挡 的 。 下 一 节 ， 
我 们 将 了 解 Spring 如 何 对 基于 SOAP 的 Web 服 务 远程 调用 提供 支持 。 

















15.5 ”发布 和 使 用 Web 服 务 


近 几 年 ， 最 流行 的 一 个 TLA“〈 三 个 字母 缩写 ) 就 是 SOA《〈 面 问 服 务 的 以 
构 ) 。SOA 对 不 同 的 人 意味 着 不 同 的 意义 。 但 是 ，SOA 的 核心 理念 是 ， 

应 用 程序 可 以 并 且 应 该 被 设计 成 依赖 于 一 组 公共 的 核心 服务 ， 而 不 是 为 
每 个 应 用 部 重新 实现 相同 的 功能 。 


例如 ， 一 个 金融 机 构 可 能 有 大 干 个 应 用 ， 其 中 很 多 都 需要 访问 借 球 者 的 
账户 信息 。 在 这 种 情况 下 ， 应 用 应 该 都 依赖 于 一 个 公共 的 获取 账户 信息 
的 服务 ， 而 不 应 该 在 每 一 个 应 用 中 部 建立 账户 访问 逻辑 (其 中 大 部 分 好 
辑 都 是 重复 的 ) 。 


Java 与 Web 服 务 的 结合 已 经 有 很 长 的 历史 了 ， 而 且 在 Java 中 使 用 Web 服 
务 有 多 种 选择 。 其 中 的 大 多 数 可 选 方案 已 经 以 某 种 方式 与 Spring 进行 了 
整合 。 虽 然 Spring 为 使 用 Java API for XML Web Service (JAX-WS) 来 
发 布 和 使 用 SOAP Web 服 务 提 供 了 大 力 文 持 ， 但 是 在 本 书 我 不 可 能 涵 善 
每 一 个 Spring 所 支持 的 Web 服 务 框 架 和 工具 箱 。 


在 本 节 ， 我 们 重新 回顾 下 Spitter 服 务 示 例 ， 不 过 这 次 我 们 将 使 用 Spring 
对 JAX-WS 的 文 持 来 把 Spitter 服 务 发 布 为 Web 服 务 并 使 用 此 Web 服 务 。 首 
先 ， 我 们 来 看 一 下 如 何在 Spring 中 创建 JAX-WS Web 服 务 。 























15.5.1 创建 基于 Spring 的 JAX-WS 端 点 


在 本 章 前 面 的 内 容 中 ， 我 们 使 用 Spring 的 服务 导出 器 创建 了 远程 服务 。 
这 些 服务 导出 器 很 神奇 地 将 Spring 配置 的 POJO 转 换 成 了 远程 服务 。 我 们 
看 到 了 如 何 使 用 RmiserviceExporter 创 建 RMI 服 务 ， 如 何 使 

用 HessianServiceExporter 创 建 Hessian 服 务 ， 如 何 使 

用 BurlapServiceExporter 创 建 Burlap 服 务 ， 以 及 如 何 使 

用 HttpInvokerServiceExporter 创 建 HTTP invoker 服 务 。 现 在 你 或 许 
期 望 我 在 本 节 展 示 如 何 使 用 一 个 JAX-WS 服 务 导 出 器 创建 Web 服 务 。 


Spring 的 确 提供 了 一 个 JAX-WS 服 务 导 出 

器 ，SimpleJaxWsServiceExporter， 我 们 很 快 就 可 以 看 到 。 但 在 这 
之 前 ， 你 必须 知道 它 并 不 一 定 是 所 有 场景 下 的 最 好 选择 。 你 是 知道 

的 ，SimpleJaxNWsServiceExporter 要 求 JAX-WS 运 行 时 文 持 将 端点 发 














布 到 指定 地 址 上 。Sun JDK 1.6 目 带 的 JAX-WS 可 以 符合 要 求 ， 但 是 其 他 
的 JAX-WS 实 现 ， 包 括 JAX-WS 的 参考 实现 ， 可 能 并 不 能 满足 此 需求 。 


如 果 我 们 将 要 部 署 的 JAX-WS 运 行 时 不 支持 将 其 发 布 到 指定 地 址 上 ， 那 
我 们 就 要 以 更 为 传统 的 方式 来 编写 JAX-WS 端 点 。 这 意味 着 端点 的 生命 
周期 由 JAX-WS 运 行 时 来 进行 管理 ， 而 不 是 Spring。 但 是 这 并 不 意味 着 
它们 不 能 装配 Spring 上 下 文中 的 bean。 


在 Spring 中 自动 装配 JAX-WS 站 点 


JAX-WS 编 程 模型 使 用 注解 将 类 和 类 的 方法 声明 为 Web 服 务 的 操作 。 使 
用 @WebService 注 解 所 标注 的 类 被 认为 Web 服 务 的 端点 ， 而 使 
用 @WebMethod 注 解 所 标注 的 方法 被 认为 是 操作 。 


就 像 大 规模 应 用 中 的 其 他 对 象 一 样 ，JAX-WS 端 点 很 可 能 需要 与 其 他 对 
象 交 互 来 完成 工作 。 这 意味 着 JAX-WS 端 点 可 以 受益 于 依赖 注入 。 但 是 
如 果 端 点 的 生命 周期 由 JAX-WS 运 行 时 来 管理 ， 而 不 是 由 Spring 来 管理 
的 话 ， 这 似乎 不 可 能 把 Spring 管理 的 bean 装 配 进 JAX-WS 管 理 的 端点 实 
例 中 。 


装配 JAX-WS 端 点 的 秘密 在 于 继承 SpringBeanAutowiringSupport。 
通过 继承 SpringBeanAutowiringSupport， 我 们 可 以 使 
用 @Autowired 注 解 标注 问 点 的 属性 ， 依 赖 就 会 自动 注入 
了 。SpitterServiceEndpoint 展 示 了 它 是 如 何 工作 的 。 











程序 清单 15.2 JAX-WS 端 点 中 的 SpitterBeanAutowiringSupport 


package com.habuma.spittr.remoting.jaxws; 
import java.util.List; 
import javax.jws .WebMethod; 
import javax.ijws.WebService; 
import org.springframework.beans.factory.annotation.Autowired; 
import 
org.springframework.web.context,.support .SpringBeanAutowiringSupport; 
import com.habuma.spittr.domain.Sspitter; 
import com.habuma.spittr.domain.SsSpittle; 
import com.habuma.spittr.service.SpitterService; 
@WebService(serviceName="SpitterService") 
public class SpitterServiceEndpoint 
extends SpringBeanAutowiringsupport { 4 启用 自动 装配 
&@Autowired 
SpitterService spitterService; 自动 装配 SpitterService 
WebMethod 


public void addspittle(Spittle spittle)} { 





spitterService.saveSpittle{spittle); 3 
EN 委托 给 
@WebMethod SpitterService 
public void deleteSpittle(long spittleId) { 
spitterService.deleteSspittle(spittleId); 
} 
@WebMethod 
public List<Spittle> getRecentSpittles(int spittleCount) { 
return spitterService.getRecentSpittles (spittleCount); 


a 委托 给 
WebMethoc 。 : 
AS 本 上 SpitterService 
public List<Spittle> getSpittlesForSpitter(Spitter spitter) 

return spitterService.getSpittlesForSpitter (spitter); 

} 


} 





我 们 在 SpitterSservice 属 性 上 使 用 @Autowired 注 解 来 表明 它 应 该 自动 
注入 一 个 从 Spring 应 用 上 下 文中 所 获取 的 bean。 在 这 里 ， 端 点 委托 注入 
的 SpitterService 来 完成 实际 的 工作 。 


导出 独立 的 JAX-WS 端 点 


正如 我 所 说 的 ， 当 对 象 的 生命 周期 不 是 由 Spring 管理 的 ， 而 对 象 的 属性 
又 需要 注入 Spring 所 管理 的 bean 时 ，SpringBeanAutowiringSupport 
很 有 用 。 在 合适 场景 下 ， 还 是 可 以 把 Spring 管理 的 bean 导 出 为 JAX-WS 
端点 的 。 


SpringSsimpleJaxWsServiceExporter 的 工作 方式 很 类 似 于 本 章 前 边 
所 介绍 的 其 他 服务 导出 器 。 它 把 Spring 管理 的 bean 发 布 为 JAX-WS 运 行 

时 中 的 服务 端点 。 与 其 他 服务 导出 器 不 

同 ，SimpleJaxWsServiceExporter 不 需要 为 它 指定 一 个 被 导出 bean 的 
用 ， 它 会 将 使 用 JAX-WS 注 解 所 标注 的 所 有 bean 发 布 为 JAX-WS 服 








SimpleJaxWsServiceExporter 可 以 使 用 如 下 的 @Bean 方 法 来 配置 : 


@Bean 
public SimpleJaxWsServiceExporter jaxWsExporter() { 


return new SimpleJaxWsServiceExporter(); 


} 





正如 我 们 所 看 到 的 ，SsimpleJaxWsServiceExporter 不 需要 再 做 其 他 
的 事情 就 可 以 完成 所 有 的 工作 。 当 启动 的 时 候 ， 它 会 搜索 Spring 应 用 上 
下 文 来 查找 所 有 使 用 @WebService 注 解 的 bean。 当 找到 符合 的 bean 

时 ，SimpleJaxWsServiceExporter 使 用 http://localhost:8080/ 地 址 将 
bean 发 布 为 JAX-WS 端 点 。SpitterServiceEndpoint 就 是 其 中 一 个 被 
但 找到 的 bean。 


程序 清单 15.3 SimpleJaxWsServiceExporter 将 bean 转 变 为 JAX-WS 端 
点 


NS 


package com.habuma.spittr.remoting.jaxws; 


import java.util.,List; 


import javax .3 ethod; 
import javax.j ervice; 





amework. beans. fac 








ringframework.stere 
spittr.domain.Spitt 
a.spittr.domain.Spittle; 


ma.spittr.service.SpitterService; 





@WebService(lserviceName="SpitterService" 
public class SpitterServiceEndpoint { 
@Autowired 
SpitterService spitterService; 自动 装配 SpitterService 


GewWebMethod 

public void adqSpittle(Spittle spittle) { 
spitterService.saveSpittle(spittle); A 。 
人 < * 1 -A svice 

} 委托 给 SpitterService 

@WebMethod 

public void deleteSpittle{long spittleId) { 


spitterService.deleteSpittle{spittleId); 


} 
@WebMethod 
eR 2 = a 三 TO 
public List<Spittle> getRecentSpittleslint spittleCount) { 委托 给 
return spitterService.getRecentSpittles(spittleCount); < SpitterService 
} 


eWebMethoa 
public List<Spittle> getSpittlesForSpitter(Spitter spitter) { 
return spitterService.getSpittlesForSpitter(spitter); 


} 


我 们 注意 到 SpitterSserviceEndpoint 的 新 实现 不 再 继 


承 SpringBeanAutowiring-Support 了 。 它 完全 就 是 一 个 Spring bean， 
因此 spitterSserviceEndpoint 不 需要 继承 任何 特殊 的 支持 类 就 可 以 实 
现 自动 装配 。 


因为 SimpleJaxNsSserviceEndpoint 的 默认 基本 地 址 

为 http://localhost:8080/， 而 SpitterServiceEndpoint 使 用 了 
@Webservice(servicename="SpitterService") 注 解 ， 所 以 这 两 个 
bean 所 形成 的 Web 服 务 地 址 均 为 http://localhost:8080/SpitterService。 但 是 
我 们 可 以 完全 控制 服务 URL， 如 末 希 望 调 整 服务 URL 的 话 ， 我 们 可 以 调 
整 基本 地 址 。 例 如 ， 如 下 Simple]JaxNsserviceEndpoint 的 配置 把 相 
同 的 服务 端点 发 布 到 http://localhost:8888 /srvices/SpitterService。 





@Bean 
public SimpleJaxWsServiceExporter jaxWsExporter() { 
SimpleJaxWsServiceExporter exporter = 


new SimpleJaxWsServiceExporter(); 
exporter.setBaseAddress("http://localhost:8888/services/"); 
} 





SimpleJaxWsServiceEndpoint 束 像 看 起 来 那么 简单 ， 但 是 我 们 应 该 
注意 它 只 能 用 在 支持 将 端点 发 布 到 指定 地 址 的 JAX-WS 运 行 时 中 。 这 包 
含 了 Sun 1.6 JDK 目 带 的 JAX-WS 运 行 时 。 其 他 的 JAX-WS 运 行 时 ， 例 如 
JAX-WS 2.1 的 参考 实现 ， 不 文 持 这 种 类 型 的 端点 发 布 ， 因 此 也 惑 不 能 使 
用 SimpleJaxWsServiceEndpoint。 


15.5.2 ”在 客户 端 代理 JAX-WS 服 务 


使 用 Spring 发 布 Web 服 务 与 我 们 使 用 RMI、Hessian、Burlap 和 HTTP 
invoker 发 布 服务 是 有 所 不 同 的 。 但 是 我 们 很 快 就 会 发 现 ， 借 助 Spring 使 
用 Web 服 务 所 涉及 的 客户 端 代理 的 工作 方式 与 基于 Spring 的 客户 端 使 用 
其 他 远程 调用 技术 是 相同 的 。 


使 用 JaxWsProxyFactoryBean， 我 们 可 以 在 Spring 中 装配 Spitter Web 服 
务 ， 与 任意 一 个 其 他 的 bean 一 样 。JaxWsProxyFactoryBean 是 Spring 工 
三 bean， 它 能 生成 一 个 知道 如 何 与 SOAP Web 服 务 交 互 的 代理 。 所 创建 
的 代理 实现 了 服务 接口 〈 如 图 15.10 所 示 ) 。 
此 ，JaxWsProxyFactoryBean 让 装配 和 使 用 一 个 远程 Web 服 务 变 成 了 
可 能 ， 就 像 这 个 远程 Web 服 务 是 本 地 POJO 一 样 。 
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图 15.10 ”JaxWsPortProxyFactoryBean 生 成 可 以 与 远程 Web 服 务 交 互 的 代理 。 这 些 代理 可 以 被 装 
配 到 其 他 bean 中 ， 就 像 它们 是 本 地 POJO 一 样 


我 们 可 以 像 下 面 这 样 配 置 JaxWsPortProxyFactoryBean 来 引用 Spitter 
服务 : 

















@Bean 
public JaxWsPortProxyFactoryBean spitterService() { 
JaxWsPortProxyFactoryBean proxy = new JaxWsPortProxyFactoryBean(); 
proxy.setWsdlDocument( 
"http://localhost:806806/services/SpitterService?wsdl1"); 


proxy.setServiceName("spitterService"); 
proxy.setPportName("spitterServiceHttpPort"); 
proxy.setServiceInterface(SpitterService.class); 
proxy.setNamespaceUri("http://spitter.com"); 
return proxy; 





我 们 可 以 看 到 ， 为 JaxWsPortProxyFactoryBean 设 置 几 个 属性 就 可 以 
工作 了 。wsdlDocumentUrl 属 性 标识 了 远程 Web 服 务 定义 文件 的 位 

置 。jJaxWsPortProxyFactory bean 将 使 用 这 个 位 置 上 可 用 的 WSDL 来 
为 服务 创建 代理 。 由 JaxWsPortProxyFactoryBean 所 生成 的 代理 实现 
了 serviceInterface 属 性 所 指定 的 SpitterService 接 口 。 


剩 下 的 三 个 属性 的 值 通 常 可 以 通过 查看 服务 的 WwWSDL 来 确定 。 为 了 演 
示 ， 我 们 假设 为 Spitter 服 务 的 WSDL 如 下 所 示 : 





<wsdl:definitions targetNamespace="http://spitter.com"> 


<wsdl:service name="spitterService"> 
<wsdl:port name="spitterServiceHttpPort" 


binding="tns:spitterServiceHttpBinding"> 


</wsdl:port> 
</wsdl:service> 
</wsdl:definitions> 





虽然 不 太 可 能 这 么 做 ， 但 是 在 服务 的 WSDL 中 定义 多 个 服务 和 端口 是 允 
许 的 。 鉴 于 此 ，JaxWsPortProxyFactoryBean 需 要 我 们 使 用 portName 
和 serviceName 属 性 指定 端口 和 服务 名 称 。WSDL 中 <wsd1:port> 和 
<wsdl:service> 元 素 的 name 属 性 可 以 帮助 我 们 识别 出 这 些 属性 该 设置 
成 什么 。 


最 后 ，namespaceUri 属 性 指定 了 服务 的 命名 空间 。 命 名 空间 将 有 助 于 
]axWsPortProxyFactoryBean 去 定位 WSDL 中 的 服务 定义 。 正 如 端口 
和 服务 名 一 样 ， 我 们 可 以 在 WSDL 中 找到 该 属性 的 正确 值 。 它 通常 会 
在 <wsdl:definitions> 的 targetNamespace 属 性 中 。 


15.6 小结 


使 用 远程 服务 通常 是 一 个 乏味 的 吾 差 事 ， 但 是 Spring 提 供 了 对 远程 服务 
的 支持 ， 让 使 用 远程 服务 与 使 用 普通 的 JavaBean 一 样 简 单 。 


在 客户 端 ，Spring 提 供 了 代理 工厂 bean， 能 让 我 们 在 Spring 应 用 中 配置 
远程 服务 。 不 管 是 使 用 RMI、Hessian、Burlap、Spring 的 HTTP 

invoker， 还 是 Web 服 务 ， 都 可 以 把 远程 服务 装配 进 我 们 的 应 用 中 ， 好 像 
它们 就 是 POJO 一 样 。Spring 其 至 捕获 了 所 有 的 RemoteExecption 寞 
常 ， 并 在 发 生 异 常 的 地 方 重新 抛 出 运行 期 异 

党 RemoteAccessException， 让 我 们 的 代码 可 以 从 处 理 不 可 恢复 的 异 
第 中 解放 出 来 。 


即便 Spring 隐藏 了 远程 服务 的 很 多 细节 ， 让 它们 表现 得 好 像 是 本 地 
JavaBean 一 样 ， 但 是 我 们 应 该 时 刻 谨 记 它 们 是 远程 服务 的 事实 。 远 程 服 
务 ， 本 质 上 来 讲 ， 通 常 比 本 地 服务 更 低 效 。 当 编写 访问 远程 服务 的 代码 
时 ， 我 们 必须 考虑 到 这 一 点 ， 限 制 远程 调用 ， 以 规避 性 能 瓶颈 。 


在 本 音 ， 我 们 看 到 了 Spring 是 如 何 使 用 几 种 基本 的 远程 调用 技术 来 发 布 
和 使 用 服务 的 。 尽 管 这 些 远 程 调 用 方案 在 分 布 式 应 用 中 很 有 价值 ， 但 这 
只 是 涉及 面向 服务 架构 〈SOA) 的 一 鳞 半 爪 。 


我 们 还 了 解 了 如 何 将 bean 导 出 为 基于 SOAP 的 Web 服 务 。 尽 管 这 是 开发 
Web 服 务 的 一 种 简单 方式 ， 但 从 架构 角度 来 看 ， 它 可 能 不 是 最 佳 的 选 
择 。 在 下 一 章 ， 我 们 将 学 习 构 建 分 布 式 应 用 的 另 一 种 选择 ， 把 应 用 暴露 
为 RESTful 资 源 。 









































第 16 章 ”使 用 Spring MVC 创 建 
REST API 


本 章 内 容 : 


。 编写 处 理 REST 资 源 的 控制 器 
。 以 XML 、JSON 及 其 他 格式 来 表述 资源 
。 使 用 REST 资 源 


数据 为 王 。 


作为 开 肥 人员 ， 我 们 经 党 关注 于 构建 伟大 的 软件 来 解决 业务 问题 。 数 据 
只 是 软件 完成 工作 时 要 处 理 的 原材料 。 但 是 如 果 你 问 一 下 业务 人 员 ， 数 
据 和 软件 谁 更 重要 的 话 ， 他 们 很 可 能 会 选择 数据 。 数 据 是 许多 业务 的 生 
ee 软件 通常 是 可 以 蔡 换 的 ， 但 是 多 年 积累 的 数据 是 永远 不 能 蔡 换 








你 是 不 是 觉得 有 些 奇 怪 ， 既 然 数据 如 此 重要 ， 为 何在 开发 软件 的 时 候 却 
经 常 将 其 视 为 事后 才 考虑 的 事情 ? 以 我 们 前 面 上 一 章 所 介绍 的 远程 服务 
为 例 ， 这 些 服务 是 以 操作 和 处 理 为 中 心 的 ， 而 不 是 信息 和 资源 。 


近 几 年 来 ， 以 信息 为 中 心 的 表述 性 状态 转移 (Representational State 
Transfer，REST) 已 成 为 替换 传统 SOAP Web 服 务 的 流行 方案 。SOAP 一 
般 会 关注 行为 和 人 处理， 而 REST 关 注 的 是 要 处 理 的 数据 。 


从 Spring 3.0 版 本 开始 ，Spring 为 创建 REST API 提 供 了 良好 的 支持 。 
Spring 的 REST 实 现在 Spring 3.1、3.2 和 如 今 的 4.0 版 本 中 不 断 得 到 发 展 。 


好 消息 是 Spring 对 REST 的 文 持 是 构建 在 Spring MVC 之 上 的 ， 所 以 我 们 
已 经 了 解 了 许多 在 Spring 中 使 用 REST 所 需 的 知识 。 在 本 章 中 ， 我 们 将 基 
于 已 了 解 的 Spring MVC 知 识 来 开发 处 理 RESTful 资 源 的 控制 器 。 但 在 深 
入 了 解 细节 之 前 ， 先 让 我 们 看 看 使 用 REST 到 底 是 什么 。 








16.1 了解 REST 


我 敢 打 赌 这 并 不 是 你 第 一 次 听 到 或 读 到 REST 这 个 词 。 近 些 年 来 ， 关 于 
REST 已 经 有 了 许多 讨论 ， 在 软件 开发 中 你 可 能 会 及 现 有 一 种 很 流行 的 
做 法 ， 那 就 是 在 推动 REST 蔡 换 SOAP Web 服 务 的 时 候 ， 会 谈论 到 SOAP 
的 不 足 


诚然 ， 对 于 许多 应 用 程序 而 言 ， 使 用 SOAP 可 能 会 有 些 大 材 小 用 了 ， 而 
REST 提 供 了 一 个 更 简单 的 可 选 方案 。 另 外 ， 很 多 的 现代 化 应 用 都 会 有 
移动 或 主 JavaScript 客 户 端 ， 它 们 都 会 使 用 运行 在 服务 占 上 REST API。 


问题 在 于 并 不 是 每 个 人 都 清楚 REST 到 底 是 什么 。 结果 就 出 现 了 许多 误 
解 。 有 很 多 打 着 REST 收 子 的 事情 其 实 并 不 符合 REST 真 正 的 本 意 。 在 谈 
论 Spring 如 何 支 持 REST 之 前 ， 我 们 需要 对 REST 是 什么 达成 共识 。 








16.1.1 ” REST 的 基础 知识 


当 谈 论 REST 时 ， 有 一 种 常见 的 错误 就 是 将 其 视 为 “基于 URL 的 Web 服 

务 ” 一 一 将 REST 作 为 男 一 种 类 型 的 远程 过 程 调 用 (remote procedure 

call，RPC) 机 制 ， 就 像 SOAP 一 样 ， 只 不 过 是 通过 简单 的 HITP URL 来 

触发 ， 而 不 是 使 用 SOAP 大 量 的 XML 命名 空间 。 

恰好 相反 ，REST 与 RPC 几 乎 没有 任何 关系 。RPC 是 面向 服务 的 ， 并 关 

而 REST 是 面向 资源 的 ， 强 调 描述 应 用 程序 的 事物 和 
词 |。 


为 了 理解 REST 是 什么 ， 我 们 将 它 的 首 字 母 缩写 拆 分 为 不 同 的 构成 部 
思 : 





。 表述 性 (Representational) : REST 资 源 实际 上 可 以 用 各 种 形式 来 
进行 表述 ， 包 括 XML、JSON (JavaScript Object Notation ) 甚至 
HTML 一 一 最 适合 资源 使 用 者 的 任意 形式 ; 

。 状态 〈State) : 当 使 用 REST 的 时 候 ， 我 们 更 关注 资源 的 状态 而 不 
是 对 资源 采取 的 行为 ; 

。 转移 〈Transfer) : REST 涉 及 到 转移 资源 数据 ， 它 以 某 种 表述 性 形 
式 从 一 个 应 用 转移 到 另 一 个 应 用 。 








更 向 污 地 讲 ，REST 束 十 将 资源 的 状态 以 最 适合 客户 端 或 服务 端的 形式 
从 服务 器 端 转移 到 客户 端 〈 或 者 反 过 来 ) 。 


在 REST 中 ， 资 源 通过 URL 进 行 识别 和 和 定位。 至 于 RESTful URL 的 的， 
并 没有 严格 的 规则 ， 但 是 URL 应 该 能 够 识别 资源 ， 而 不 是 简单 的 发 一 条 
命令 到 服务 器 上 。 再 次 强调 ， 关 注 的 核心 是 事物 ， 而 不 是 行为 。 


REST 中 会 有 行为 ， 它 们 是 通过 HTTP 方 法 来 定义 的 。 有 具体 来 讲 ， 也 就 
是 GET、POST、PUT、DELETE、PATCH 以 及 其 他 的 HTTP 方 法 构成 了 
REST 中 的 动作 。 这 些 HTTP 方 法 通常 会 匹配 为 如 下 的 CRUD 动 作 : 


Create: POST 

Read: GET 

Update: PUT 或 PATCH 
Delete: DELETE 


尽管 通常 来 讲 ，HTTP 方 法 会 映射 为 CRUD 动 作 ， 但 这 并 不 是 严格 的 限 
制 。 有 时候 ，PUT 可 以 用 来 创建 新 资源 ，POST 可 以 用 来 更 新 资源 。 实 际 
上 上 ，POST 请 求 非 昭 等 性 (non-idempotent〉 的 特点 使 其 成 为 一 个 非常 灵 
活 的 方法 ， 对 于 无 法 适应 其 他 HTTP 方 法 语义 的 操作 ， 它 都 能 够 胜任 。 


基于 对 REST 的 这 种 观点 ， 所 以 我 尽量 避免 使 用 诸如 REST 服 务 、REST 
Web 服 务 或 类 似 的 术语 ， 这 些 术语 会 不 恰当 地 强调 行为 。 相 反 ， 我 更 愿 
意 强 调 REST 面 同 资 源 的 本 质 ， 并 讨论 RESTful 资 源 。 


16.1.2 ”Spring 是 如 何 文 持 REST 的 


Spring 很 早 就 有 导出 REST 资 源 的 需求 。 从 3.0 版 本 开始 ，Spring 针 对 
Spring MVC 的 一 些 增 强 功 能 对 REST 提 供 了 良好 的 支持 。 当 前 的 4.0 版 本 
中 ，Spring 文 持 以 下 方式 来 创建 REST 资 源 : 


。 控制 器 可 以 处 理 所 有 的 HTTP 方 法 ， 包 含 四 个 主要 的 REST 方 
法 : GET、PUT、DELETE 以 及 POST。Spring 3.2 及 以 上 版 本 还 支持 
PATCH 方法 ; 

。 借助 @PathVariable 注 解 ， 控 制 嚣 能够 处 理 参数 化 的 URL (将 变量 
输入 作为 UREL 的 一 部 分 ) ; 

。 借助 Spring 的 视图 和 视图 解析 器 ， 资 源 能 够 以 多 种 方式 进行 表述 ， 
包括 将 模型 数据 演 染 为 XML、JSON、Atom 以 及 RSS 的 View 实 现 ; 


。 可 以 使 用 ContentNegotiatingViewResolver 来 选择 最 适合 客户 
问 的 表述 ; 

。 借助 @ResponseBody 注 解 和 各 种 HttpMethodConverter 实 现 ， 能 
够 蔡 换 基于 视图 的 演 染 方式 ; 

。 类 似 地 ，@RequestBody 注 解 以 及 HttpMethodConverter 实 现 可 以 
将 传 入 的 HTTP 数 据 转 化 为 传 入 控制 器 处 理 方法 的 Java 对 象 ; 

。 借助 RestTemplate，Spring 应 用 能 够 方便 地 使 用 REST 资 源 。 


本 章 中 ， 我 们 将 会 介绍 Spring RESTfu 的 所 有 特性 ， 首 先 介绍 如 何 借助 
Spring MVC 生 成 资源 。 然 后 在 16.4 小 节 中 ， 我 们 会 转 问 REST 的 客户 
端 ， 看 一 下 如 何 使 用 这 些 资源 。 那 么 ， 就 从 了 解 RESTful Spring MVC 控 
制 器 是 什么 样子 开始 吧 。 


16.2 ”创建 第 一 个 REST 疹 点 


借助 Spring 的 支持 来 实现 REST 功 能 有 一 个 很 有 利 的 地 方 ， 那 就 是 我 们 已 
经 掌握 了 很 多 创建 RESTful 控 制 器 的 知识 。 从 第 5 章 到 第 7 章 中 ， 我 们 学 
到 了 创建 Web 应 用 的 知识 ， 它 们 可 以 用 在 通过 REST API 暴 露 资 源 上 。 首 
pe RS Eitt leApiContr ol ler 
REST 端 点 。 


如 下 的 程序 清单 展现 了 这 个 新 REST 控 制 器 起 始 的 样子 ， 它 会 提供 
Spittle 资 源 。 这 是 一 个 很 简单 的 开始 ， 但 是 在 本 章 中 ， 随 着 不 断 学 习 
Spring REST 编 程 模型 的 细节 ， 我 们 将 会 不 断 构 建 这 个 控制 器 。 


程序 清单 16.1 实现 RESTful 功 能 的 Spring MVC 控 制 嚣 











package spittr.api; 


import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework.web.bind.annotation.RequestParam; 
import spittr.Spittle; 

import spittr.data.SpittleRepository; 


@Controller 
@RequestMapping("/spittles") 
public class SpittleController { 


private static final String MAX LONG AS STRING="92233726368547758067"; 
private SpittleRepository spittleRepository; 


@Autowired 

public SpittleController(SpittleRepository spittleRepository) { 
this.spittleRepository = spittleRepository; 

} 


@RequestMapping(method=RequestMethod.GET) 
public List<Spittle> spittles( 
@Requestparam(value="max", 
defaultValue=MAX_ LONG AS_ STRING) long max， 


O@RequestParam(value="count"，defaultValue="26") int count) { 


Peturn spittleRepository.findSpittles(max, count); 
} 
} 





让 我 们 仔细 看 一 下 程序 清单 16.1。 你 能 够 看 出 来 它 服务 于 一 个 REST 资 源 
而 不 是 Web 页 面 吗 ? 


可 能 看 不 出 来 ! 按照 这 个 控制 器 的 写法 ， 并 没有 地 方 表明 它 是 
RESTful、 服 务 于 资源 的 控制 器 。 实 际 上 ， 你 也 许 能 够 认 出 这 
个 spittles() 方 法 ， 我 们 曾经 在 第 5 章 〈5.3.1 小 节 ) 见 过 它 。 


我 们 回忆 一 下 ， 当 发 起 对 “/spittles” 的 GET 请 求 时 ， 将 会 调 

用 spittles() 方 法 。 它 会 查找 并 返回 spittle 列 表 ， 而 这 个 列表 会 通 
过 注入 的 SpittleRepository 获 取 到 。 列 表 会 放 到 模型 中 ， 用 于 视图 
的 泻 染 。 对 于 其 于 浏览 器 的 Web 应 用 ， 这 可 能 意味 着 模型 数据 会 演 染 到 
HTML 页 面 中 。 


但 是 ， 我 们 现在 讨论 的 是 创建 REST API。 在 这 种 情况 下 ，HTML 并 不 是 
合适 的 数据 表述 形式 。 


表述 是 REST 中 很 重要 的 一 个 方面 。 它 是 关于 客户 端 和 服务 器 端 针 对 某 

一 资源 是 如 何 通信 的 。 任 何 给 定 的 资源 都 几乎 可 以 用 任意 的 形式 来 进行 
表述 。 如 果 资 源 的 使 用 者 愿意 使 用 JSON， 那 么 资源 就 可 以 用 JSON 格 式 
来 表述 。 如 果 使 用 者 喜欢 尖 插 号 ， 那 相同 的 资源 可 以 用 XML 来 进行 表 

述 。 同 时 ， 如 果 用 户 在 浏览 器 中 查看 资源 的 话 ， 可 能 更 愿意 以 HTML 的 
方式 来 展现 (或 者 PDF、Excel 及 其 他 便于 人 类 阅读 的 格式 ) 。 资 源 没 有 
变化 一 一 只 是 它 的 表述 方式 变化 了 。 

汉 时 尽管 spring 支 持 多 种 资源 表述 形式 ， 但 是 在 定义 REST API 的 时 候 ， 不 一 定 要 全 部 使 用 
它们 。 对 于 大 多 数 客 户 端 来 说 ， 用 JSON 和 XML 来 进行 表述 就 足够 了 。 


当然 ， 如 果 内 容 要 由 人 类 用 户 来 使 用 的 话 ， 那 么 我 们 可 能 需要 支持 
HTML 格 式 的 资源 。 根 据 资 源 的 特点 和 应 用 的 需求 ， 我 们 还 可 能 选择 使 
用 PDF 文 档 或 Excel 表 格 来 展现 资源 。 


对 于 非 人 类 用 户 的 使 用 者 ， 比 如 其 他 的 应 用 或 调用 REST 端 点 的 代码 ， 
资源 表述 的 首选 应 该 是 XML 和 JSON。 借 助 Spring 同 时 支持 这 两 种 方案 















































非常 简单 ， 所 以 没有 必要 做 一 个 非 此 即 彼 的 选择 。 


按照 我 的 意见 ， 我 推荐 至 少 要 支持 JSON。JSON 使 用 起 来 至 少 会 像 XML 
一 样 简单 (很 多 人 会 说 JSON 会 更 加 简单 ) ， 并 且 如 果 客 户 端 是 
JavaScript〈( 最 近 一 段 时 间 以 来 ， 这 种 做 法 越 来 越 常 见 ) 的 话 ，JSON 更 
是 会 成 为 优胜 者 ， 因 为 在 JavaScript 中 使 用 JSON 数 据 根 本 就 不 需要 编排 
和 解 排 Cmarshaling/demarshaling) 。 


再 要 了 解 的 是 控制 嚣 本身 通 名 并 不 关心 资源 如 何 表述 。 控 制 右 以 Java 对 
象 的 方式 来 处 理 资 源 。 控 制 器 完成 了 它 的 工作 之 后 ， 资 源 才 会 被 转化 成 
最 适合 客户 端的 形式 。 


二 
述 形式 : 


。 内 容 协商 〈Content negotiation) : 选择 一 个 视图 ， 它 能 够 将 模型 痊 
染 为 呈现 给 客户 端的 表述 形式 ; 

。 消 晨 转换 器 (Message conversion) : 通过 一 个 消息 转换 器 将 控制 器 
所 返回 的 对 象 转换 为 呈现 给 客户 端的 表述 形式 。 


鉴于 我 们 在 第 5 章 和 第 6 草 中 已 经 讨论 过 视图 解析 器 ， 并 且 已 经 熟悉 了 基 
于 视图 的 泻 染 《在 第 6 草 中 ) ， 所 以 首先 看 一 下 如 何 使 用 内 容 协 商 来 选 
择 视 图 或 视图 解析 器 ， 它 们 将 资源 泻 染 为 客户 端 能 够 接受 的 形式 。 


16.2.1 协商 资源 表述 


你 可 以 回忆 一 下 在 第 5 章 中 《以 及 图 5.1 所 示 ) ， 当 控制 器 的 处 理 方法 完 
成 时 ， 通 常会 返回 一 个 逻辑 视图 名 。 如 果 方 法 不 直接 返回 逻辑 视图 名 
《例如 方法 返回 void) ， 那 么 逻辑 视图 名 会 根据 请 求 的 URL 判 断 得 
出 。DispatcherServlet 接 下 来 会 将 视图 的 名 字 传 递 给 一 个 视图 解析 
器 ， 要 求 它 来 帮助 确定 应 该 用 哪个 视图 来 泻 染 请 求 结果 。 

在 面 加 人 类 访问 的 web 应 用 程序 中 ， 选 择 的 视图 通常 来 讲 都 会 泻 染 为 
HTML。 视 图 解析 方案 是 个 简单 的 一 维 活 动 。 如 果 根 据 视 图 名 匹配 上 了 
视图 ， 那 这 就 是 我 们 要 用 的 视图 了 。 

当 要 将 视图 名 解析 为 能 够 产生 资源 表述 的 视图 时 ， 我 们 就 有 男 外 一 个 维 
度 需 要 考虑 了 。 视 图 不 仪 要 匹配 视图 名 ， 而 且 所 选择 的 视图 要 适合 客户 


























端 。 如 果 客 户 端 想 要 JSON， 那 么 演 染 HTML 的 视图 就 不 行 了 一 一 尽管 
视图 名 可 能 匹配 。 


Spring 的 ContentNegotiatingViewResolver 是 一 个 特殊 的 视图 解析 
器 ， 它 考虑 到 了 客户 端 所 需要 的 内 容 类 型 。 按 照 其 最 简单 的 形 

式 ，ContentNegotiatingViewResolver 可 以 按照 下 述 形式 进行 配 
置 : 


@Bean 
public ViewResolver cnViewResolver() { 


return new ContentNegotiatingViewResolver(); 


} 





在 这 个 简单 的 bean 声 明 背 后 会 涉及 到 很 多 事情 。 要 理解 
ContentNegotiating-ViewResolver 是 如 何 工作 的 ， 这 涉及 内 容 协 商 
的 两 个 步骤 : 


1. 确定 请 求 的 媒体 类 型 
2. 找到 适合 请 求 媒体 类 型 的 最 佳 视图 。 


让 我 们 深入 了 解 每 个 步骤 来 了 解 ContentNegotiatingViewResolver 
是 如 何 完 成 其 任务 的 ， 首 先 从 弄 明日 客户 端 需 要 什么 类 型 的 内 容 开 始 。 


确定 请 求 的 媒体 类 型 


在 内 容 协 商 两 步骤 中 ， 第 一 步 是 确定 客户 端 想 要 什么 类 型 的 内 容 表 述 。 
表面 上 看 ， 这 似乎 是 一 个 很 简单 的 事情 。 难 道 请 求 的 Accept 头 部 信息 
不 是 已 经 很 清楚 地 表明 要 发 送 什么 样 的 表述 给 客户 端 吗 ? 


遗憾 的 是 ，Accept 头 部 信息 并 不 总 是 可 靠 的 。 如 果 客 户 端 是 web 浏 览 
器 ， 那 并 不 能 保证 客户 端 需要 的 类 型 就 是 浏览 器 在 Accept 头 部 所 发 送 
的 值 。Web 浏 览 器 一 般 只 接受 对 人 类 用 户 友好 的 内 容 类 型 (如 
text/html〉， 所 以 没有 办 法 (除了 面向 开发 人 员 的 浏览 器 插件 〉 指定 
不 同 的 内 容 类 型 。 


ContentNegotiatingViewResolver 将 会 考虑 到 Accept 头 部 信息 并 使 
用 它 所 请 求 的 媒体 类 型 ， 但 是 它 会 首先 但 看 URL 的 文件 扩展 名 。 如 果 
URL 在 结尾 处 有 文件 扩展 名 的 




















话 ，ContentNegotiatingViewResolver 将 会 基于 该 扩展 名 确定 所 需 

的 类 型 。 如 果 扩 展 名 是 “.json” 的 话 ， 那 么 所 需 的 内 容 类 型 必须 

是 “application/json”。 如 果 扩 展 名 是 “.xml*”， 那 么 客户 端 请 求 的 就 

是 “application/xml”。 当 然 ,，“.html”* 扩 展 名 表明 客户 端 所 需 的 资源 表 
述 为 HTML (text/html) 。 


如 果 根 据 文件 扩展 名 不 能 得 到 任何 媒体 类 型 的 话 ， 那 就 会 考虑 请 求 中 的 
Accept 头 部 信息 。 在 这 种 情况 下 ，Accept 头 部 信息 中 的 值 就 表明 了 客 
户 端 想 要 的 MIME 类 型 ， 没 有 必要 再 去 查找 了 。 


最 后 ， 如 果 没 有 Accept 头 部 信息 ， 并 且 扩 展 名 也 无 法 提供 帮助 的 
话 ，ContentNegotiatingViewResolver 将 会 使 用 “/” 作 为 默认 的 内 容 
类 型 ， 这 就 意味 着 客户 端 必须 要 接收 服务 器 发 送 的 任何 形式 的 表述 。 


一 旦 内 容 类 型 确定 之 后 ，ContentNegotiatingViewResolver 就 该 将 
逻辑 视图 名 解析 为 泻 染 模型 的 Visw。 与 Spring 的 其 他 视图 解析 器 不 

同 ，ContentNegotiatingViewResolver 本 身 不 会 解析 视图 。 而 是 委 
托 给 其 他 的 视图 解析 器 ， 让 它们 来 解析 视图 。 


ContentNegotiatingViewResolver 要 求 其 他 的 视图 解析 器 将 逻辑 视 
图 名 解析 为 视图 。 解 析 得 到 的 每 个 视图 都 会 放 到 一 个 列表 中 。 这 个 列表 
装配 完成 后 ，ContentNegotiatingViewResolver 会 循环 客户 端 请 求 
的 所 有 媒体 类 型 ， 在 候选 的 视图 中 碍 找 能 够 产生 对 应 内 容 类 型 的 视图 。 
第 一 个 匹配 的 视图 会 用 来 演 染 模型 。 


影响 媒体 类 型 的 选择 


在 上 述 的 选择 过 程 中 ， 我 们 前 述 了 确定 所 请 求 媒 体 类 型 的 默认 策略 。 但 
是 通过 为 其 设置 一 个 ContentNegotiationManager， 我 们 能 够 改变 它 
的 行为 。 借 助 Content-NegotiationManager 我 们 所 能 做 到 的 事情 如 

下 所 示 : 


。 指定 默认 的 内 容 类 型 ， 如 果 根 据 请 求 无 法 得 到 内 容 类 型 的 话 ， 将 会 
使 用 默认 值 ; 

。 通过 请 求 参数 指定 内 容 类 型 ; 

。 忽视 请 求 的 Accept 头 部 信息 ; 

。 将 请 求 的 扩展 名 映射 为 特定 的 媒体 类 型 ; 

e。 将 JAF (Java Activation Framework ) 作为 根据 扩展 名 查找 媒体 类 型 




















的 备用 方案 。 
有 三 种 配置 ContentNegotiationManager 的 方法 : 


。 直接 声明 一 个 ContentNegotiationManager 类 型 的 bean:; 

。 通 过 ContentNegotiationManagerFactoryBean 间 接 创 建 bean; 

。 重 载 NebMvcConfigurerAdapter 的 
configureContentNegotiation() 方 法 。 


直接 创建 ContentNegotiationManager 有 一 些 复杂 ， 除 非 有 充分 的 原 
因 ， 人 否则 我 们 不 会 愿意 这 样 做 。 后 两 种 方案 能 够 让 创建 
ContentNegotiationManager 更 加 简单 。 


ContentNegotiationManager 是 在 Spring 3.2 中 加 入 的 


ContentNegotiationManager 是 Spring 中 相对 比较 新 的 功能 ， 是 
在 Spring 3.2 中 引入 的 。 在 Spring 3.2 之 

前 ，ContentNegotiatingViewResolver 的 很 多 行为 都 是 通过 直 
接 设置 ContentNegotiatingViewResolver 的 属性 进行 配置 的 。 
从 Spring 3.2 开 始 ，Content-NegotiatingViewResolver 的 大 多 数 
Setter 方 法 都 废弃 了 ， 鼓 励 通过 Content-NegotiationManager 来 
进行 配置 。 


尽管 我 不 会 在 本 章 中 介绍 配 

置 ContentNegotiatingViewResolver 的 旧 方 法 ， 但 是 我 们 在 创 
建 ContentNegotiationManager 所 设置 的 很 多 属性 ， 

在 ContentNegotiatingViewResolver 中 都 有 对 应 的 属性 。 如 果 
你 使 用 较 早 版 本 的 Spring 的 话 ， 应 该 能 够 很 容易 地 将 新 的 配置 方式 
对 应 到 旧 配 置 方式 中 。 


一 般 而 言 ， 如 果 我 们 使 用 XML 配 置 ContentNegotiationManager 的 
话 ， 那 最 有 用 的 将 会 是 ContentNegotiationManagerFactoryBean。 
例如 ， 我 们 可 能 希望 在 XML 中 配置 ContentNegotiationManager 使 
用 “application/json” 作 为 默认 的 内 容 类 型 : 


<bean id="contentNegotiationManager" 


class="org.springframework.http.ContentNegotiationManagerFactoryBean" 
p:defaultContentType="application/json"> 





因为 ContentNegotiationManagerFactoryBean 是 FactoryBean 的 实 
现 ， 所 以 它 会 创建 一 个 ContentNegotiationManager bean。 这 
个 ContentNegotiationManager 能 够 注入 

到 ContentNegotiatingViewResolver 的 
contentNegotiationManager 属 性 中 。 


如 果 使 用 Java 配 置 的 话 ， 获 得 ContentNegotiationManager 的 最 简便 
方法 就 是 扩展 WebMvcConfigurerAdapter 并 重 

载 configureContentNegotiation() 方 法 。 在 创建 Spring MVC 应 用 的 
时 候 ， 我 们 很 可 能 已 经 扩展 了 WebMvcConfigurerAdapter。 例 如 ， 在 
Spittr 应 用 中 ， 我 们 已 经 有 了 WebMvcConfigurerAdapter 的 扩展 类 ， 名 
为 WebConfig， 所 以 需要 做 的 就 是 重 

载 configureContentNegotiation() 方 法 。 如 下 束 

是 configureContentNegotiation() 的 一 个 实现 ， 它 设置 了 默认 的 内 
容 类 型 : 








@Override 
public void configureContentNegotiation( 


ContentNegotiationConfigurer configurer) { 
configurer.defaultContentType(MediaType.APPLICATION_JSON); 
} 





我 们 可 以 看 到 ，configureContentNegotiation() 方 法 给 定 了 一 
个 Content-NegotiationConfigurer 对 

象 。ContentNegotiationConfigurer 中 的 一 些 方 法 对 应 于 
ContentNegotiationManager 的 Setter 方 法 ， 这 样 我 们 就 能 

在 ContentNegotiation-Manager 创 建 时 ， 设 置 任意 内 容 协商 相关 的 
属性 。 在 本 例 中 ， 我 们 调用 defaultContentType( ) 方 法 将 默认 的 内 容 
类 型 设置 为 “application/json”。 


现在 ， 我 们 已 经 有 了 ContentNegotiationManagerbean， 接 下 来 就 需 
要 将 它 注 入 到 ContentNegotiatingViewResolver 的 
contentNegotiationManager 属 性 中 。 这 需要 我 们 稍微 修改 一 下 之 前 
声明 ContentNegotiatingViewResolver 的 @Bean 方 法 : 





@Bean 
public ViewResolver cnViewResolver(ContentNegotiationManager cnm) { 
ContentNegotiatingViewResolver cnvr = 
new ContentNegotiatingViewResolver(); 


cnvr.setContentNegotiationManager(cnm); 
return cnvr; 


} 


这 个 @Bean 方 法 注入 了 ContentNegotiationManager， 并 使 用 它 调用 
了 setContentNegotiationManager()。 这 样 的 结果 就 

是 ContentNegotiatingView、Resolver 将 会 使 

用 ContentNegotiationManager 所 定义 的 行为 。 








配置 ContentNegotiationManager 有 很 多 的 细节 ， 在 这 里 无 法 对 它们 
进行 一 一 介绍 。 如 下 的 程序 清单 是 一 个 非常 简单 的 配置 样 例 ， 当 我 使 
用 ContentNegotiating-ViewResolver 的 时 候 ， 通 常会 采用 这 种 用 
法 : 人 但 是 对 特定 的 视图 名 称 将 会 演 染 为 
JSON 输 出 。 





程序 清单 16.2 ”配置 ContentNegotiationManager 





GeBean 
3 七 Mana 
{ 
YYPe .TEXT_HTMLDL) ， 二 器 认 为 HTML 
GBean 
public ViewResolver beanNameViewResolver!() { < 以 bean 的 形式 查找 视图 
return n BeanNameVi ewR lver(); A 

} 
&@Bean 
public View spittles() { 

return new MappingJackson2JsonView!{); 3 将 “spittles” 定义 为 JSON 视图 

} 


除了 程序 清单 16.2 中 的 内 容 以 外 ， 还 应 该 有 一 个 能 够 处 理 HTML 的 视图 
解析 器 (如 InternalResourceViewResolver 

或 TilesViewResolver) 。 在 大 多 数 场景 

下 ，ContentNegotiatingViewResolver 会 假设 客户 端 需要 HTML， 
如 ContentNegotiationManager 配 置 所 示 。 但 是 ， 如 果 客 户 端 指 定 了 
它 想 要 JSON 〈 通 过 在 请 求 路 径 上 使 用 *.json? 扩 展 名 或 Accept 头 部 信息 ) 
的 话 ， 那 么 ContentNegotiatingViewResolver 将 会 查找 能 够 处 理 
JSON 视 图 的 视图 解析 器 。 








如 果 逻 辑 视图 的 名 称 为 “spittles”， 那 么 我 们 所 配置 的 
BeanNameViewResolver 将 会 解析 spittles() 方 法 中 所 声明 的 View。 
这 是 因为 bean 名 称 匹 配 逻 辑 视图 的 名 称 。 如 果 没 有 匹配 的 View 的 

话 ，ContentNegotiatingViewResolver 将 会 采用 默认 的 行为 ， 将 其 
输出 为 HTML 。 


ContentNegotiatingViewResolver 一 旦 能 够 确定 客户 端 想 要 什么 样 
的 媒体 类 型 ， 接 下 来 就 是 查找 泻 染 这 种 内 容 的 视图 。 


ContentNegotiatingViewResolver 的 优势 与 限制 








ContentNegotiatingViewResolver 最 大 的 优势 在 于 ， 它 在 Spring 
MVC 之 上 构建 了 REST 资 源 表 述 层 ， 控 制 占 代码 无 需 修 改 。 相 同 的 一 套 
控制 器 方法 能 够 为 面 同 人 类 的 用 户 产 生 HTML 内 容 ， 也 能 针对 不 是 人 类 
的 客户 端 产 生 JSON 或 XML 。 


如 果 面 向 人 类 用 户 的 接口 与 面向 非 人 类 客户 端的 接口 之 间 有 很 多 重 登 的 
话 ， 那 么 内 容 协 商 是 一 种 很 便利 的 方案 。 在 实践 中 ， 面 向 人 类 用 户 的 视 
图 与 REST API 在 细节 上 很 少 能 够 处 于 相同 的 级 别 。 如 果 面 向 人 类 用 户 
的 接口 与 面向 非 人 类 客户 端的 接口 之 间 没 有 太 多 重 羞 的话， 那 

么 ContentNegotiatingViewResolver 的 优势 就 体现 不 出 来 了 。 























ContentNegotiatingViewResolver 还 有 一 个 严重 的 限制 。 作 为 
ViewResolver 的 实现 ， 它 只 能 决定 资源 该 如 何 演 染 到 客户 疾 ， 并 没有 涉 
及 到 客户 端 要 发 送 什 么 样 的 表述 给 控制 器 使 用 。 如 果 客 户 端 发 送 JSON 
或 XML 的 话 ， 那 么 ContentNegotiatingViewResolver 就 无 法 提供 帮 
助 了 ; 


ContentNegotiatingViewResolver 还 有 一 个 相关 的 小 问题 ， 所 选中 
的 View 会 泻 染 模型 给 客户 端 ， 而 不 是 资源 。 这 里 有 个 细微 但 很 重要 的 区 








别 。 当 客户 端 请 求 JSON 格 式 的 Spittle 对 象 列 表 时 ， 客 户 端 希望 得 到 
的 啊 应 可 能 如 下 所 示 : 





"id": 42， 

"latitude": 28.419489， 
"longitude": -81.581184, 
"message": "Hello World!", 


"time": 1466389266666 


"id": 43， 

"latitude": 28.419136， 
"longitude": -81.577225， 
"message": "Blast off!", 
"time": 1460475666666 


"spittleList": [ 


"id": 42， 
"latitude": 28.419489， 
"longitude": -81.581184， 


"message": "Hello World!" 
"time": 1466389266666 


"id": 43， 

"latitude": 28.419136， 
"longitude": -81.577225， 
"message": "Blast off!", 
"time": 1460475666666 








尽管 这 不 是 很 严重 的 问题 ， 但 确实 可 能 不 是 客户 端 所 预期 的 结果 。 


因为 有 这 些 限制 ， 我 通常 建议 不 要 使 
用 ContentNegotiatingViewResolver。 我 更 加 倾向 于 使 用 Spring 的 消 
轧 转 换 功 能 来 生成 资源 表述 。 接 下 来 ， 我 们 看 一 下 如 何在 控制 器 代码 中 
使 用 Spring 的 消息 转换 器 。 


16.2.2 ”使 用 HTTP 信 息 转 换 器 


消息 转换 (message conversion) 提供 了 一 种 更 为 直接 的 方式 ， 它 能 够 将 
控制 器 产生 的 数据 转换 为 服务 于 客户 端的 表述 形式 。 当 使 用 消息 转换 功 





能 时 ，DispatcherServlet 不 再 需要 那么 且 烦 地 将 模型 数据 传送 到 视 
图 中 。 实 际 上 ， 这 里 根本 就 没有 模型 ， 也 没有 视图 ， 只 有 控制 器 产生 的 
以 及 消息 转换 器 (message converter) 转换 数据 之 后 所 产生 的 资 


Spring 自 带 了 各 种 各 样 的 转换 器 ， 如 表 16.1 所 示 ， 这 些 转换 器 满足 了 最 
常见 的 将 对 象 转换 为 表述 的 需要 。 


例如 ， 假 设 客户 端 通过 请 求 的 Accept 头 信息 表明 它 能 接 

受 “application/json”， 并 且 Jackson JSON 在 类 路 径 下 ， 那 么 处 理 方 
法 返回 的 对 象 将 交 给 MappingJacksonHttp-MessageConverter， 并 
由 它 转换 为 返回 客户 端的 JSON 表 述 形式 。 另 一 方面 ， 如 果 请 求 的 头 信 
息 表明 客户 端 想 要 “text/xm1” 格 式 ， 那 

么 Jaxb2RootElementHttpMessage-Converter 将 会 为 客户 端 产生 
XMLIN NY。 


注意 ， 表 16.1 中 的 HITP 信 息 转 换 器 除了 其 中 的 五 个 以 外 都 是 自动 注册 
的 ， 所 以 要 使 用 它们 的 话 ， 不 需要 Spring 配置 。 但 是 为 了 文 持 它们 ， 你 
需要 添加 一 些 库 到 应 用 程序 的 类 路 径 下 。 例 如 ， 如 果 你 想 使 

用 MappingJacksonHttpMessageConverter 来 实现 JSON 消 息 和 Java 对 
象 的 互相 转换 ， 那 么 需要 将 Jackson JSON Processor 库 谎 加 到 类 路 径 
中 。 类 似 地 ， 如 果 你 想 使 

用 Jaxb2RootE1ementHttpMessageConverter 来 实现 XML 消息 和 Java 
对 象 的 互相 转换 ， 那 么 需要 JAXB 库 。 如 果 信 息 是 Atom 或 RSS 格 式 的 
话 ， 那 么 Atom-FeedHttpMessageConverter 和 
RssChannelHttpMessageConverter 会 需要 Rome 库 。 

















表 16.1 Spring 提供 了 多 个 HTTP 信 ee 于 实现 资源 表述 与 各 种 Java 类 型 之 间 的 互相 


信息 转换 器 


Rome Feed 对 象 和 Atom feed (媒体 类 型 


AtomFeedHttpMessageConverter application/atom+xml ) 之 间 的 互相 转换 。 
如 果 Rome 包 在 类 路 径 下 将 会 进行 注册 











BufferedImageHttpMessageConverter BufferedImages 与 图 片 二 进 制 数据 之 间 互相 转换 


ByteArrayHttpMessageConverter 


FormHttpMessageConverter 


Jaxb2RootElementHttpMessageConverter 


MappingJacksonHttpMessageConverter 


MappingJackson2HttpMessageConverter 


MarshallingHttpMessageConverter 


ResourceHttpMessageConverter 


RssChannelHttpMessageConverter 


SourceHttpMessageConverter 


读 取 / 写 入 字 节 数组 。 从 所 有 媒体 类 型 (*/*) 
中 读 取 ， 并 以 application/octet-stream 格 式 写 
入 





将 application/x-www-form-urlencoded 内 容 读 入 
到 MultivalueMap<string,Sstring> 中 ， 也 会 

将 MultivalueMap<Sstring,String> 写 入 

到 application/x-www-form- urlencoded 中 或 

将 MultivalueMap<Sstring， object> 写 入 

到 multipart/form-data 中 


在 XML (text/xml 或 application/xml1) 和 使 用 
JAXB2 注 解 的 对 象 间 互相 读 取 和 写 入 。 
如 果 JAXB v2 库 在 类 路 径 下 ， 将 进行 注册 























在 JSON 和 类 型 化 的 对 象 或 非 类 型 化 的 
HashMap 间 互相 读 取 和 写 入 。 

如 果 Jackson JSON 库 在 类 路 径 下 ， 将 进行 注 
册 








在 JSON 和 类 型 化 的 对 象 或 非 类 型 化 的 
HashMap 间 互相 读 取 和 写 入 。 

如 果 Jackson 2 JSON 库 在 类 路 径 下 ， 将 进行 注 
册 























使 用 注入 的 编排 器 和 解 排 器 (marshaller 和 

unmarshaller) 来 读 入 和 写 入 XML 。 文 持 的 乡 
排 器 和 解 排 器 包括 Castor、JAXB2、JIBX、 

XMLBeans 以 及 Xstream 

















读 取 或 写 入 Resource 


在 RSS feed 和 Rome Channel 对 象 间 互相 读 取 或 
写 入 。 
如 果 Rome 库 在 类 路 径 下 ， 将 进行 注册 








在 XML 和 javax.xml.transform.source 对 象 间 互 
相 读 取 和 写 入 。 


将 所 有 媒体 类 型 〈*/* ) 读 取 为 string。 将 
String 写 入 为 text/plain 


StringHttpMessageConverter 


FormHttpMessageConverter 的 扩展 ， 使 
5 志 甚 
XmlAwareFormHttpMessageConverter 周 SourceHttp MessageConverte r 来 支持 基于 XML 


的 部 分 























你 可 能 已 经 猜 到 了 ， 为 了 文 持 消 息 转 换 ， 我 们 需要 对 Spring MVC 的 编程 
模型 进行 一 些小 调整 。 


在 啊 应 体 中 返回 资源 状态 


正常 情况 下 ， 当 处 理 方 法 返回 Java 对 象 ( 除 String 外 或 View 的 实现 以 
外 ) 时， 这 个 对 象 会 放 在 模型 中 并 在 视图 中 泻 染 使 用 。 但 是 ， 如 果 使 用 
了 消息 转换 功能 的 话 ， 我 们 需要 告诉 Spring 跳 过 正常 的 模型 /视图 流程 ， 
并 使 用 消息 转换 器 。 有 不 少 方式 都 能 做 到 这 一 点 ， 但 是 最 简单 的 方法 是 
为 控制 器 方法 添加 @ResponseBody 注 解 。 


重新 看 一 下 程序 清单 16.1 中 的 spittles() 方 法 ， 我 们 可 以 为 其 添 
加 @ResponseBody 注 解 ， 这 样 瓯 能 让 Spring 将 方法 返回 的 
List<Spittle> 转 换 为 响应 体 ; 





@RequestMapping(method=RequestMethod .GET, 
produces="application/json") 
public @ResponseBody List<Spittle> spittles( 
@Requestparam(value="max", 
defaultValue=MAX_ LONG AS_STRING) long max, 
@Requestparam(value="count", defaultValue="286") int count) { 


return spittleRepository.findSpittles(max, count); 


} 





@ResponseBody 注 解 会 告知 Spring， 我 们 要 将 返回 的 对 象 作为 资源 发 送 
给 客户 端 ， 并 将 其 转换 为 客户 端 可 接受 的 表述 形式 。 更 具体 地 

讲 ，DispatcherServlet 将 会 考虑 到 请 求 中 Accept 头 部 信息 ， 并 得 找 
能 够 为 客户 端 提供 所 需 表述 形式 的 消 恩 转换 器 。 


举例 来 讲 ， 假 设 客户 端的 Accept 头 部 信息 表明 它 接 

受 “application/json”， 并 且 Jackson JSON 库 位 于 应 用 的 类 路 径 下 ， 

那么 将 会 选择 MappingJacksonHttpMessage-Converter 

或 MappingJackson2HttpMessageConverter (这 取决 于 类 路 径 下 是 
哪个 版 本 的 Jackson) 。 消 息 转换 器 会 将 控制 器 返回 的 Spittle 列 表 转 换 为 
JSON 文 档 ， 并 将 其 写 入 到 响应 体 中 。 响 应 大 臻 会 如 下 所 示 : 


"id": 42， 

"latitude": 28.419489， 
"longitude": -81.581184, 
"message": "Hello World!" 
"time": 14660389266666 


"id": 43, 

"latitude": 28.419136， 
"longitude": -81.577225, 
"message": "Blast off!", 
"time": 14660475666666 





Jackson 默 认 会 使 用 反射 


注意 在 默认 情况 下 ，Jackson JSON 库 在 将 返回 的 对 象 转换 为 JSON 资 源 表 
述 时 ， 会 使 用 反射 。 对 于 简单 的 表述 内 容 来 讲 ， 这 没有 什么 问题 。 但 是 
如 果 你 重 构 了 Java 类 型 ， 比 如 添加 、 移 除 或 重 命名 属性 ， 那 么 所 产生 的 
JSON 也 将 会 发 生变 化 〈 如 果 客 户 端 依赖 这 些 属性 的 话 ， 那 客户 端 有 可 


能 会 出 错 ) 。 


但 是 ， 我 们 可 以 在 Java 类 型 上 使 用 Jackson 的 映射 注解 ， 从 而 改变 产生 
JSON 的 行为 。 这 样 我 们 就 能 更 多 地 控制 所 产生 的 JSON， 从 而 防止 它 影 
响 到 API 或 客户 端 。 


Jackson 映 射 注解 的 内 容 超出 了 本 书 的 讨论 范围 ， 不 过 关于 这 个 主题 ， 
在 http://wiki.fasterxml.com/Jackson-Annotations 上 有 一 些 有 用 的 文档 。 








谈 及 Accept 头 部 信息 ， 请 注意 getSpitter() 的 @ORequestMapping 注 
解 。 在 这 里 ， 我 使 用 了 produces 属 性 表明 这 个 方法 只 处 理 预期 输出 为 


JSON 的 请 求 。 也 了 是 说 ， 这 个 方法 只 会 处 理 Accept 头 部 信息 包 

含 “application/json” 的 请 求 。 其 他 任何 类 型 的 请 求 ， 即 使 它 的 URL 
匹配 指定 的 路 径 并 且 是 GET 请 求 也 不 会 被 这 个 方法 处 理 。 这 样 的 请 求 会 
被 其 他 的 方法 来 进行 处 理 〈 如 果 存 在 适当 方法 的 话 ) ， 或 者 返回 客户 端 
HTTP 406 (Not Acceptable) 响应 。 


在 请 求 体 中 接收 资源 状态 


到 目前 为 止 ， 我 们 只 关注 了 REST 端 点 如 何 为 客户 端 提 供 资 源 。 但 是 
REST 并 不 是 只 读 的 ，REST API 也 可 以 接受 来 自 客 户 端的 资源 表述 。 如 
果 要 让 控制 器 将 客户 端 发 送 的 JSON 和 XML 转换 为 它 所 使 用 的 Java 对 

象 ， 那 是 非常 不 方便 的 。 在 处 理 逻 辑 离 开 控制 器 的 时 候 ，Spring 的 消息 
转换 器 能 够 将 对 象 转换 为 表述 一 一 它们 能 不 能 在 表述 传 入 的 时 候 完 成 相 
同 的 任务 呢 ? 


Q@ResponseBody 能 够 告诉 Spring 在 把 数据 发 送 给 客户 端的 时 候 ， 要 使 用 
某 一 个 消息 器 ， 与 之 类 似 ，@RequestBody 也 能 告诉 Spring 查找 一 个 消 

恩 转 换 器 ， 将 来 自 客 户 端的 资源 表述 转换 为 对 象 。 例 如 ， 假 设 我 们 需要 
一 种 方式 将 客户 端 提 交 的 新 Spittle 保 存 起 来 。 我 们 可 以 按照 如 下 的 方 
式 编写 控制 器 方法 来 处 理 这 种 请 求 : 











@RequestMapping( 
method=RequestMethod.POST 
consumes="application/json") 


public @ResponseBody 
Spittle saveSpittle(@RequestBody Spittle spittle) { 
return spittleRepository.save(spittle); 


} 


如 果 忽 略 掉 注解 的 话 ， 那 saveSpittle() 是 一 个 非常 简单 的 方法 。 它 接 
受 一 个 spittle 对 象 作 为 参数 ， 并 使 用 spittleRepository 进 行 保存 ， 
最 终 返 回 spittleRepository .save() 方 法 所 得 到 的 Spittle 对 象 。 


但 是 ， 通 过 使 用 注解 ， 它 会 变 得 更 加 有 意思 也 更 加 强 

大 。@RequestMapping 表 明 它 只 能 处 理 “/spittles”( 在 类 级 别 的 
@RequestMapping 中 进行 了 声明 〉 的 POST 请 求 。POST 请 求 体 中 预期 要 
包含 一 个 Spittle 的 资源 表述 。 因 为 Spittle 参 数 上 使 用 了 
@RequestBody， 所 以 Spring 将 会 查看 请 求 中 的 Content -Type 头 部 信 
轧 ， 并 得 找 能 够 将 请 求 体 转换 为 Spittle 的 消息 转换 器 。 








例如 ， 如 果 客 户 端 发 送 的 Spittle 数 据 是 JSON 表 述 形式 ， 那 
么 Content-Type 头 部 信息 可 能 就 会 是 “application/json”。 在 这 种 

情况 下 ，DispatcherServlet 会 查找 能 够 将 JSON 转 换 为 Java 对 象 的 消 

尽 转 换 器 。 如 果 Jackson 2 库 在 类 路 径 中 ， 那 

么 MappingJackson2HttpMessageConverter 将 会 担 此 重任 ， 将 JSON 
表述 转换 为 Spittle， 然 后 传递 到 saveSpittle() 方 法 中 。 这 个 方法 还 
使 用 了 @ResponseBody 注 解 ， 因 此 方法 返回 的 Spittle 对 象 将 会 转换 为 
某 种 资源 表述 ， 友 送 给 客户 站 。 


注意 ，@RequestMapping 有 一 个 consumes 属 性 ， 我 们 将 其 设置 

为 “application/ json”。consumes 属 性 的 工作 方式 类 似 于 
produces， 不 过 它 会 关注 请 求 的 Content-Type 头 部 信息 。 它 会 告诉 
Spring 这 个 方法 只 会 处 理 对 “/ spittles” 的 POST 请 求 ， 并 且 要 求 请 求 的 
Content -Type 头 部 信息 为 “application/json”。 如 果 无 法 满足 这 些 
条 件 的 话 ， 会 由 其 他 方法 (如 果 存 在 合适 的 方法 的 话 ) 来 处 理 请 求 。 


为 控制 器 默认 设置 消息 转换 
当 处 理 请 求 时 ，@ResponseBody 和 @RequestBody 是 启用 消息 转换 的 一 


种 简洁 和 强大 方式 。 但 是 ， 如 果 你 所 编写 的 控制 闫 有 多 个 方法 ， 并 且 每 
人 那么 这 些 注解 束 会 带 来 一 定 程度 的 重 
| 














Spring 4.0 引 入 了 @RestController 注 解 ， 能 够 在 这 个 方面 给 我 们 提供 
帮助 。 如 果 在 控制 器 类 上 使 用 @RestController 来 代替 @Controller 
的 话 ，Spring 将 会 为 该 控制 器 的 所 有 处 理 方 法 应 用 消息 转换 功能 。 我 们 
不 必 为 每 个 方法 都 添加 @ResponseBody 了 。 我 们 所 定义 的 
SpittleController 可 能 就 会 如 下 所 示 : 


程序 清单 16.3 ”使 用 @RestController 注 解 


Package spittr.api; 

import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.RestController; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import org.springframework .web.bind.annotation.RequestParam; 
import spittr.Spittle:; 

import spittr.data.SpittleRepository; 


@RestController = 一 默认 使 用 消息 转换 
@RequestMapping("/spittles") 
public class SpittleController { 

private static final String MAX_LONG _AS_STRING="9223372036854775807"; 


private SpittleRepository spittleRepository; 


@Autowired 
public SpittleController!lSpittleRepository spittleRepository) { 
this.spittleRepository = spittleRepository; 


} 


&@RequestMapping (method=RequestMethod .GET) 
public List<Spittle> spittles! 
@RegquestParamlvalue="max", 
defaultValue=MAX_LONG_AS_STRING) long max, 
@RequestParam(value="count", defaultValue="20") int count) { 


return spittleRepository.findSspittles (max, count); 


} 


@RequestMapping! 
method=RegquestMethod.POST 
consumes="application/json") 
public Spittle saveSpittle{l@ReaquestBody Spittle spittle) { 
return spittleRepository.savelspittle); 
} 
} 


程序 清单 16.3 的 关键 点 在 于 代码 中 此 时 不 包含 什么 。 这 两 个 处 理 器 方法 
都 没有 使 用 @ResponseBody 注 解 ， 因 为 控制 器 使 用 了 
@RestController， 所 以 它 的 方法 所 返回 的 对 象 将 会 通过 消息 转换 机 
制 ， 产 生 客 户 端 所 需 的 资源 表述 。 


到 目前 为 止 ， 我们 看 到 了 如 何 使 用 Spring MVC 编 程 模型 将 RESTful 资 源 
发 布 到 啊 应 体 之 中 。 但 是 啊 应 除了 负载 以 外 还 会 有 其 他 的 内 容 。 头 部 信 
上 和 状态 码 也 能 够 为 客户 端 提供 啊 应 的 有 用 信息 。 接 下 来 ， 我 们 看 一 下 
在 提供 资源 的 时 候 ， 如 何 填充 头 部 信息 和 设置 状态 码 。 


16.3 ”提供 资源 之 外 的 其 他 内 容 


@ResponseBody 提 供 了 一 种 很 有 用 的 方式 ， 能 够 将 控制 器 返回 的 Java 对 
象 转换 为 发 送 到 客户 端的 资源 表述 。 实 际 上 ， 将 资源 表述 发 送 给 客户 端 
只 是 整个 过 程 的 一 部 分 。 一 个 好 的 REST API 不 仅 能 够 在 客户 端 和 服务 
器 之 间 传 递 资源 ， 它 还 能 够 给 客户 端 提 供 额外 的 元 数据 ， 帮 助 客户 端 理 
解 资 源 或 者 在 请 求 中 出 现 了 什么 情况 。 








16.3.1 发送 错误 信息 到 客户 端 


例如 ， 我 们 为 SpittleController 添 加 一 个 新 的 处 理 器 方法 ， 它 会 提 
供 单 个 spittle 对 象 : 


@RequestMapping(value="/{id}", method=RequestMethod.GET) 
public @ResponseBody Spittle spittleById(@PathVariable long id) { 


return spittleRepository.findOne(id); 





在 这 里 ， 通 过 id 参 数 传 入 了 一 个 ID， 然 后 根据 它 调 用 Repository 的 
findOne() 方 法 ， 但 找 spittle 对 象 。 处 理 器 方法 会 返回 findOne() 方 
法 得 到 的 Spittle 对 象 ， 消 息 转 换 器 会 负责 产生 客户 端 所 需 的 资源 表 


非常 简单 ， 对 吧 ? 我 们 没 办 法 让 它 更 棒 了 。 它 还 能 更 好 吗 ? 


如 果 根 据 给 定 的 ID， 无 法 找到 某 个 Spittle 对 象 的 ID 属性 能 够 与 之 匹 
配 ，findone() 方 法 返回 nul1 的 时 候 ， 你 觉得 会 发 生 什 么 呢 ? 


结果 就 是 spittleById() 方 法 会 返回 null1， 啊 应 体 为 空 ， 不 会 返回 任 
何 有 用 的 数据 给 客户 端 。 同 时 ， 啊 应 中 默认 的 HTTP 状 态 码 是 
200 (OK) ， 表 示 所 有 的 事情 运行 正常 。 


但 是 ， 所 有 的 事情 都 是 不 对 的 。 客 尸 端 要 求 Spittle 对 象 ， 但 是 它 什 么 
都 没有 得 到 。 它 既 没 有 收 到 spittle 对 象 也 没有 收 到 任何 消息 表明 出 现 
J 服务 器 实际 上 是 在 说 : “这 是 一 个 没 用 的 啊 应 ， 但 是 能 够 告诉 
尔 一 切 都 正 第 ! ” 











现在 ， 我 们 考虑 一 下 在 这 种 场景 下 应 该 发 生 什 么 。 至 少 ， 状 态 码 不 应 访 
是 200， 而 应 该 是 404 (Not Found) ， 告 诉 客户 端 它们 所 要 求 的 内 容 没 
有 找到 。 如 果 啊 应 体 中 能 够 包含 错误 信息 而 不 是 空 的 话 就 更 好 了 。 


Spring 提供 了 多 种 方式 来 处 理 这 样 的 场景 : 


。 使 用 @ResponseStatus 注 解 可 以 指定 状态 码 ; 

。 控制 器 方法 可 以 返回 ResponseEntity 对 象 ， 该 对 象 能 够 包含 更 多 
响应 相关 的 元 数据 ; 

。 ee 这 样 处 理 器 方法 就 能 关注 于 正常 的 
C7。 


在 这 个 方面 ，Spring 提 供 了 很 多 的 灵活 性 ， 其 实 也 不 存在 唯一 正确 的 方 
式 。 我 不 会 用 某 一 种 固定 的 策略 来 处 理 所 有 的 错误 或 涵盖 所 有 的 场景 ， 
而 是 会 向 读者 展现 多 种 修改 spittleById() 的 方法 ， 以 应 对 Spittle 无 
法 找到 的 场景 。 


使 用 ResponseEntity 


作为 @ResponseBody 的 蔡 代 方案 ， 探 制 占 方法 可 以 返回 一 
个 ResponseEntity 对 象 。ResponseEntity 中 可 以 包含 啊 应 相关 的 元 
数据 (如 头 部 信息 和 状态 码 〉 以 及 要 转换 成 资源 表述 的 对 象 。 


因为 ResponseEntity 人 允许 我 们 指定 啊 应 的 状态 码 ， 所 以 当 无 法 找 
到 spittle 的 时 候 ， 我 们 可 以 返回 HTTP 404 错 误 。 如 下 是 新 版 本 的 
spittleById()， 它 会 返回 ResponseEntity: 











@RequestMapping(value="/{id}", method=RequestMethod.GET) 
public ResponseEntity<Spittle> spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOone(id); 


HttpStatus status = spittle != null ? 
HttpStatus.0OKk : HttpStatus.NOT FOUND; 
return new ResponseEntity<Spittle>(spittle, status); 


} 


像 前 面 一 样 ， 路 径 中 得 到 的 ID 用 来 从 Repository 中 检索 Spittle。 如 果 
找到 的 话 ， 状 态 码 设置 为 HttpStatus .0K (这 是 之 前 的 默认 值 ) ， 但 是 
如 果 Repository 返 回 nul1 的 话 ， 状 态 码 设置 

为 HttpStatus.NOT_FOUND， 这 会 转换 为 HTTP 404。 最 后 ， 会 创建 一 





个 新 的 ResponseEntity， 它 会 把 Spittle 和 状态 码 传 送 给 客户 端 。 


注意 这 个 spittleById() 方 法 没有 使 用 @ResponseBody 注 解 。 除 了 包 
含 啊 应 头 信息 、 状 态 码 以 及 负载 以 外 ，ResponseEntity 还 包含 了 
Q@ResponseBody 的 语义 ， 因 此 负载 部 分 将 会 泻 染 到 响应 体 中 ， 就 像 之 前 
在 方法 上 使 用 @ResponseBody 注 解 一 样 。 如 果 返 回 ResponseEntity 的 
话 ， 那 就 没有 必要 在 方法 上 使 用 @ResponseBody 注 解 了 。 

我 们 在 正确 的 方 同 上 走出 了 第 一 步 ， 如 果 所 要 求 的 Spittle 无 法 找到 的 
话 ， 客 户 端 能 够 得 到 一 个 合适 的 状态 码 。 但 是 在 本 例 中 ， 响 应 体 依 然 为 
空 。 我 们 可 能 会 希望 在 响应 体 中 包含 一 些 错误 信息 。 


我 们 重 试 一 次 ， 首 先 定 义 一 个 包 售 错误 信息 的 Error 对 象 : 








public class Error { 
private int code; 
private String message; 


public Error(int code, String message) { 
this.code = code; 
this.message = message; 


} 


public int getCode() { 
return code; 


} 


public String getMessage() { 
return message; 
} 
} 





然后 ， 我 们 可 以 修改 spittleById()， 让 它 返 回 Error: 


@RequestMapping(value="/{id}", method=RequestMethod.GET) 
public ResponseEntity<?> spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOne(id); 
if (spittle == null) { 


Error error = new Error(4, "Spittle [" + id + "] not found"); 
return new ResponseEntity<Error>(error, HttpStatus.NOT_ FOUND); 
} 
return new ResponseEntity<Spittle>(spittle, HttpStatus.OK); 
} 





现在 ， 这 个 方法 的 行为 已 经 符合 我 们 的 预期 了 。 如 果 找 到 spittle 的 
话 ， 就 会 把 返回 的 对 象 以 及 200 (OK) 的 状态 码 封装 

到 ResponseEntity 中 。 另 一 方面 ， 如 果 findone() 返 回 nul1 的 话 ， 将 
会 创建 一 个 Error 对 象 ， 并 将 其 与 404 (Not Found) 状态 码 一 起 封装 
到 ResponseEntity 中 ， 然 后 返回 。 


你 也 许 觉 得 我 们 可 以 到 此 结束 这 个 话题 了 。 毕 竟 ， 方 法 按照 我 们 期 望 的 
方式 在 运行 。 但 是 ， 还 有 一 点 事情 让 我 不 太 和 舒服 。 

首先 ， 这 比 我 们 开始 的 时 候 更 为 复杂 。 涉 及 到 了 更 多 的 逻辑 ， 包 括 条 件 
语句 。 另 外 ， 方 法 返回 ResponseEntity<?> 感 觉 有 些 问 


题 。ResponseEntity 上 所 使 用 的 泛 型 为 它 的 解析 或 出 现 错误 留 下 了 太 多 
的 空间 。 


不 过 ， 我 们 可 以 借助 错误 处 理 器 来 修正 这 些 问题 。 

处 理 错误 

spittleById() 方 法 中 的 证 代码 块 是 处 理 错误 的 ， 但 这 是 控制 器 中 错 
误 处 理 器 (error handler) 所 擅长 的 领域 。 错 误 处 理 嚣 能够 处 理 导致 问题 
的 场景 ， 这 样 常规 的 处 理 器 方法 束 能 只 关心 正常 的 逻辑 处 理 路 径 了 。 


我 们 重 构 一 下 代码 来 使 用 错误 处 理 器 。 首 先 ， 定 义 能 够 对 应 
SpittleNotFound-Exception 的 错误 处 理 器 : 








@ExceptionHandler(SpittleNotFoundException.class) 
public ResponseEntity<Error> spittleNotFound( 
SpittleNotFoundException e) { 


long spittleId = e.getSpittleId(); 
Error error = new Error(4, "Spittle [" + spittleId + "] not found"); 
return new ResponseEntity<Error>(error, HttpStatus.NOT_ FOUND); 

} 








@ExceptionHandler 注 解 能 够 用 到 控制 占 方 法 中 ， 用 来 处 理 特定 的 异 
常 。 这 里 ， 它 表明 如 果 在 控制 器 的 任意 处 理 方法 中 抛 出 
SpittleNotFoundException 异 常 ， 束 会 调用 spittleNotFound() 方 
法 来 处 理 异常 。 


至 于 SpittleNotFoundException， 它 是 一 个 很 简单 异常 类 : 


public class SpittleNotFoundException extends RuntimeException { 
private long spittleld; 
public SpittleNotFoundException(long spittleId) { 
this.spittleId = spittleId ; 


public long getSpittleId() { 
return spittleld; 


} 
} 


现在 ， 我 们 可 以 移 除 掉 spittleById() 方 法 中 大 多 数 的 错误 处 理 代码 : 





@RequestMapping(value="/{id}", method=RequestMethod.GET) 

public ResponseEntity<Spittle> spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOone(id); 
if (spittle == null) { throw new SpittleNotFoundException(id); } 
return new ResponseEntity<Spittle>(spittle, HttpStatus.OK); 


} 


这 个 版 本 的 spittleById() 方 法 确实 干净 了 很 多 。 除 了 对 返回 值 进 
行 hull 检 查 ， 它 完全 关注 于 成 功 的 场景 ， 也 束 是 能 够 找到 请 求 的 
Spittle。 同 时 ， 在 返回 类 型 中 ， 我 们 能 移 除 抒 奇 怪 的 泛 型 了 。 


不 过 ， 我 们 能 够 让 代码 更 加 干净 一 些 。 现 在 我 们 已 经 知 

道 spittleById() 将 会 i 

200 (OK) ， 那 么 就 可 以 不 再 使 用 ResponseEntity， ， 
为 OResponseBody: 








@RequestMapping(value="/{id}", method=RequestMethod.GET) 

public @ResponseBody Spittle spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOne(id); 
if (spittle == null) { throw new SpittleNotFoundException(id); } 
return spittle; 


} 


当然 ， 如 果 控 制 器 类 上 使 用 了 @Restcontroller， 我 们 甚至 不 再 需要 
@ResponseBody: 








@RequestMapping(value="/{id}", method=RequestMethod.GET) 
public Spittle spittleById(@PathVariable long id) { 
Spittle spittle = spittleRepository.findOne(id); 
if (spittle == null) { throw new SpittleNotFoundException(id); } 


return spittle; 
} 


鉴于 错误 处 理 器 的 方法 会 始终 返回 Error， 并 且 HTTP 状 态 码 为 
404 (Not Found) ， 那 么 现在 我 们 可 以 对 spittleNotFound() 方 法 进行 
类 似 的 清理 : 


@ExceptionHandler(SpittleNotFoundException.class) 
@ResponseStatus(HttpStatus.NOT_ FOUND) 
public @ResponseBody Error spittleNotFound(SpittleNotFoundException e) { 


long spittleId = e.getSpittleId(); 
return new Error(4, "Spittle [" + spittleId + "] not found"); 
} 





因为 spittleNotFound() 方 法 始终 会 返回 Error， 所 以 使 

用 ResponseEntity 的 唯一 原因 束 是 能 够 设置 状态 码 。 但 是 通过 

为 spittleNotFound() 方 法 添 

加 @ResponseSstatus(HttpStatus.NOT_FOUND) 注 解 ， 我 们 可 以 达到 
相同 的 效果 ， 而 且 可 以 不 绸 使 用 ResponseEntity 了 。 


同样 ， 如 果 控 制 器 类 上 使 用 了 @RestController， 那 么 就 可 以 移 除 掉 
@ResponseBody， 让 代码 更 加 干净 : 





@ExceptionHandler(SpittleNotFoundException.class) 
@ResponseStatus(HttpStatus.NOT_ FOUND) 
public Error spittleNotFound(SpittleNotFoundException e) { 


long spittleId = e.getSpittleId() ; 
return new Error(4, "Spittle [" + spittleId + "] not found"); 
} 


在 一 定 程度 上 ， 我 们 已 经 圆满 达到 了 想 要 的 效果 。 为 了 设置 啊 应 状态 
码 ， 我 们 首先 使 用 ResponseEntity， 但 是 稍 后 我 们 借助 异常 处 理 器 以 
及 @ResponseSstatus， 避 人 免 使 用 ResponseEntity， 从 而 让 代码 更 加 整 
EE 


;6 。 








似乎 ， 我 们 不 再 需要 使 用 ResponseEntity 了 。 但 是 ， 有 一 种 场 
景 ResponseEntity 能 够 很 好 地 完成 ， 但 是 其 他 的 注解 或 异常 处 理 器 却 
做 不 到 。 现 在 ， 我 们 看 一 下 如 何在 响应 中 设置 头 部 信息 。 


16.3.2 ”在 啊 应 中 设置 头 部 信息 














在 saveSpittle() 方 法 中 ， 我 们 在 处 理 POST 请 求 的 过 程 中 创建 了 一 个 
新 的 Spittle 资 源 。 但 是 ， 按 照 目 前 的 写法 (参考 程序 清单 16.3) ， 我 
们 无 法 准确 地 与 客户 端 交 流 。 


在 saveSpittle() 处 理 完 请 求 之 后 ， 服 务 器 在 响应 体 中 包含 了 Spittle 
的 表述 以 及 HTTP 状 态 码 200 (OK) ， 将 其 返回 给 客户 端 。 这 里 没有 什 
么 大 问题 ， 但 是 还 不 是 完全 准确 。 


当然 ， 假 设 处 理 请 求 的 过 程 中 成 功 创建 了 资源 ， 状 态 可 以 视 为 OK。 但 
是 ， 我 们 不 仅仅 需要 说 “OK”。 我 们 创建 了 新 的 内 容 ，HTTP 状 态 码 也 将 
这 种 情况 告诉 给 了 客户 端 。 不 过 ，HTTP 201 不 仅 能 够 表明 请 求 成 功 完 
成 ， 而 且 还 能 描述 创建 了 新 资源 。 如 果 我 们 希望 完整 准确 地 与 客户 端 交 
流 ， 那 么 响应 是 不 是 应 该 为 201 (Created) ， 而 不 仅仅 是 200 (OK) 
呢 ? 


根据 我 们 目前 所 学 到 的 知识 ， 这 个 问题 解决 起 来 很 容易 。 我 们 需要 做 的 
就 是 为 saveSpittle() 方 法 添加 @ResponseStatus 注 解 ， 如 下 所 示 : 








@RequestMapping( 
method=RequestMethod.POST 
consumes="application/json") 


@ResponseStatus(HttpStatus.CREATED) 
public Spittle saveSpittle(@RequestBody Spittle spittle) { 
return spittleRepository.save(spittle); 


} 





这 应 该 能 够 完成 我 们 的 任务 ， 现 在 状态 码 能 够 精确 反应 发 生 了 什么 情 
况 。 它 告诉 客户 站 我 们 新 创建 了 资源 。 问 题 已 经 得 以 解决 ! 


但 这 只 是 问题 的 一 部 分 。 客 户 端 知道 新 创建 了 资源 ， 你 觉得 客户 端 会 不 
会 感 兴趣 新 创建 的 资源 在 哪里 昵 ? 毕竟 ， 这 是 一 个 新 创建 的 资源 ， 会 有 
一 个 新 的 UREL 与 之 关联 。 难 道 客 户 端 只 能 猜测 新 创建 资源 的 UREL 是 什么 
吗 ? 我 们 能 不 能 以 某 种 方式 将 其 告诉 客户 端 ? 

当 创 建新 资源 的 时 候 ， 将 资源 的 URL 放 在 响应 的 Location 头 部 信息 
中 ， 并 返回 给 客户 端 是 一 种 很 好 的 方式 。 因 此 ， 我 们 需要 有 一 种 方式 来 
填充 响应 头 部 信息 ， 此 时 我 们 的 老 朋 友 ResponseEntity 就 能 提供 帮助 
于 











如 下 的 程序 清单 展现 了 一 个 新 版 本 的 saveSpittle()， 它 会 返回 
ResponseEntity 用 来 告诉 客户 端 新 创建 的 资源 。 


程序 清单 16.4 当 返 回 ResponseEntity 时 ， 在 啊 应 中 设置 头 部 信息 





public ResponseEntity<Spi ittle saveSpittle! 
QRequestBody Spittle spittle) { 





= spittleRepository ve lspittle < 获取 Spittle 
new HttpHeaders(); < 一 设置 Location 头 部 信息 

URI .create( 

:8080/ ee ttr/spittles/" + spittle.getId!()); 
ation(locatic i 

ResponseEntity<Sp le> responseEntity = < 创建 ResponseEntity 

new Respons Entity<Spitt] 
spittle, da ers, EL OAC 


return sponseEnt 二 -2Y 1 


在 这 个 新 的 版 本 中 ， 我 们 创建 了 一 个 HttpHeaders 实 例 ， 用 来 存放 希望 
在 啊 应 中 包含 的 头 部 信息 值 。HttpHeaders 

是 MultiValueMap<String，Sstring> 的 特殊 实现 ， 它 有 一 些 便利 的 
Setter 方 法 〈 如 setLocation()) ， 用 来 设置 常见 的 HTTP 头 部 信息 。 在 
得 到 新 创建 Spittle 资 源 的 URL 之 后 ， 接 下 来 使 用 这 个 头 部 信息 来 创建 
ResponseEntity。 


哇 ! 原本 简单 的 saveSpittle() 方 法 瞬间 变 得 爱 肿 了 。 但 是 ， 更 值得 关 
注 的 是 ， 它 使 用 硬 编 码 值 的 方式 来 构建 Location 头 部 信息 。URL 

中 “localhost” 以 及 “8080” 这 两 个 部 分 尤其 需要 注意 ， 因 为 如 果 我 们 将 应 
用 部 署 到 其 他 地 方 ， 而 不 是 在 本 地 运行 的 话 ， 它 们 就 不 适用 了 。 


我 们 其 实 没 有 必要 手动 构建 URL，Spring 提 供 了 

UriComponentsBuilder， 可 以 给 我 们 一 些 带 助 。 是 一 个 构建 类 

过 逐步 指定 URL 中 的 各 种 组 成 部 分 〈 如 host、 端 口 、 “ 雍 欠 以 及 查询 》 ; 

我 们 能 够 使 用 它 来 构建 UriComponents 实 例 。 借助 

| 我 们 就 能 获得 
适合 设置 给 Location 头 部 信息 的 URI。 


为 了 使 用 UriComponentsBuilder， 我 们 需要 做 的 就 是 在 处 理 器 方法 中 
将 其 作为 一 个 参数 ， 如 下 面 的 程序 清单 所 示 。 





程序 清单 16.5 ”使 用 UriComponentsBuilder 来 构建 Location URI 


@ReaqauestMappingl 


给 定 UriComponentsBuilder 


.., 计算 Location URI 





headers.setLocation(locationUri); 


ResponseEntity<Spittle> EE nseEntity = 
new Resp eEntity<Spittle>!( 





tle, headers, HttpStatus .CREATED) 
responseEntity; 





在 处 理 器 方法 所 得 到 的 UriComponentsBuilder 中 ， 会 预先 配置 已 知 的 
信息 如 host、 端 口 以 及 Servlet 内 容 。 它 会 从 处 理 占 方法 所 对 应 的 请 求 中 
获取 这 些 基 础 信息 。 基 于 这 些 信息 ， 代 码 会 通过 设置 路 径 的 方式 构建 

UriComponents 其 余 的 部 分 。 


注意 ， 路 径 的 构建 分 为 两 步 。 第 一 步调 用 path() 方 法 ， 将 其 设置 为 “/ 
spittles/”， 也 就 是 这 个 控制 器 所 能 处 理 的 基础 路 径 。 然 后 ， 在 第 二 
次 调用 path() 的 时 候 ， 使 用 了 已 保存 Spitt1le 的 ID 。 我 们 可 以 推 新 出 
来 ， 每 次 调用 path() 都 会 基于 上 次 调用 的 结 


在 路 径 设 置 完成 之 后 ， 调 用 build( ) 方 法 来 构建 UriComponents 对 象 ， 
根据 这 个 对 象 调用 toUri( ) 束 能 得 到 新 创建 spittle 的 URI。 


在 REST API 中 暴露 资源 只 代表 了 会 话 的 一 端 。 如 果 发 布 的 API 没 有 人 关 
心 和 使 用 的 话 ， 那 也 没有 什么 价值 。 通常 来 讲 ， 移动 或 JavaScript 应 用 会 
是 REST API 的 客户 端 ， 但 是 Spring 应 用 也 完全 可 以 使 用 这 些 资源 。 我 们 
换个 方向 ， 看 一 下 如 何 编写 Spring 代码 实现 RESTful 交 互 的 客户 端 。 











16.4 编写 REST 客 户 端 

作为 客户 端 ， 编 写 与 REST 资 源 交 互 的 代码 可 能 会 比较 乏味 ， 并 且 所 编 
写 的 代码 都 是 样板 式 的 。 例 如 ， 假 设 我 们 需要 借助 Facebook 的 Graph 
API， 编 写 方法 来 获取 某 人 的 Facebook 基 本 人 信息。 不过， 获取 基本 信息 
的 代码 会 有 点 复杂 ， 如 下 面 的 程序 清单 所 示 。 


程序 清单 16.6 ”使 用 Apache HTTP Client 获 取 Facebook 中 的 个 人 基本 


已 4D 








Str 
Gey 疼 
>、 HttpClient client = HttpClients,.createDefault(); Ea Pa 
创建 k : a 创建 客 / 1 
请 求 HttpGet request = new HttpGet ("http://graph.facebook.com/" + id); 
将 响应 HttpResponse response = client .execute(lrequest); I 
映射 为 执行 请 求 


对 象 HEPE 
» ObjectMappe 





你 可 以 看 到 ， 在 使 用 REST 资 源 的 时 候 涉及 很 多 代码 。 这 里 我 甚至 还 偷 
懒 使 用 了 Jakarta Commons HTTP Client 发 起 请 求 并 使 用 Jackson JSON 
processor 解 析 啊 应 。 


仔细 看 一 下 fetchFacebookProfile() 方 法 ， 你 可 能 会 发 现 方 法 中 只 有 
少量 代码 与 获取 Facebook 个 人 信息 直接 相关 。 如 果 你 要 编写 男 一 个 方法 
来 使 用 其 他 的 REST 资 源 ， 很 可 能 会 有 很 多 代码 是 

与 fetchFacebookProfile() 相 同 的 。 


为 外 ， 还 有 一 些 地 方 可 能 会 抛 出 的 IOException 异 常 。 
为 IOException 是 检查 型 异常 ， 所 以 要 么 捕获 它 ， 要 么 抛 出 它 。 在 本 示 
例 中 ， 我 选择 捕获 它 并 在 它 的 位 置 重 新 抛 出 一 个 非 检 查 型 异 


常 RuntimeException。 
鉴于 在 资源 使 用 上 有 如 此 之 多 的 样板 代码 ， 你 可 能 会 觉得 最 好 的 方式 是 


封装 通用 代码 并 参数 化 可 变 的 部 分 。 这 正 是 Spring 的 RestTemplate 所 
做 的 事情 。 就 像 J]JdbcTemplate 处 理 了 JDBC 数 据 访 问 时 的 丑陋 部 





分 ，RestTemplate 让 我 们 在 使 用 RESTful 资 源 时 免 于 编写 那些 乏味 的 代 
码 。 


稍 后 ， 我 们 将 会 看 到 如 何 借助 RestTemplate 重 写 
fetchFacebookProfile() 方 法 ， 这 会 戏剧 性 的 简化 该 方法 并 消除 抒 样 
i 但 首先 ， 让 我 们 整体 了 解 一 下 RestTemplate 提 供 的 所 有 
REST 操 作 。 


16.4.1 了 解 RestTemplate 的 操作 


RestTemplate 定 义 了 36 个 与 REST 资 源 交 互 的 方法 ， 其 中 的 大 多 数 都 对 
应 于 HTTP 的 方法 。 但 是 ， 在 本 章 中 我 没有 足够 的 篇 幅 池 盖 所 有 的 36 个 
方法 。 其 实 ， 这 里 面具 有 11 个 独立 的 方法 ， 其 中 有 十 个 有 三 种 重 载 形 
式 ， 而 第 十 一 个 则 重 载 了 六 次 ， 这 样 一共 形 成 了 36 个 方法 。 表 16.2 描 述 
了 RestTemplate 所 提供 的 11 个 独立 方法 。 


除了 TRACE 以 外 ， Rn 除 此 之 
外 ，execute() 和 exchange() 提 供 了 较 低 层次 的 通用 方法 来 使 用 任意 
的 HTTP 方 法 。 


表 16.2 中 的 大 多 数 操作 都 以 三 种 方法 的 形式 进行 了 重 载 : 


。 一 个 使 用 java.net.URI 作 为 URL 格 式 ， 不 支持 参数 化 URL; 
。 一 个 使 用 String 作 为 URL 格 式 ， 并 使 用 Map 指 明 URL 参 数 ; 
。 人 并 使 用 可 变 参 数列 表 指 明 URL 参 


明确 了 RestTemplate 所 提供 的 11 个 操作 以 及 各 个 变种 如 何 工 作 之 后 ， 
你 就 能 以 自己 的 方式 编写 使 用 REST 资 源 的 客户 端 了 。 我 们 通过 对 四 个 
主要 HTTP 方 法 的 支持 〈 也 就 是 GET、PUT、DELETE 和 POST) 来 研 

究 RestTemplate 的 操作 。 我 们 从 GET 方 法 的 getFor0bject() 和 
getForEntity() 开 始 。 


表 16.2 ”RestTemplate 定 义 了 11 个 独立 的 操作 ， 而 每 一 个 都 有 重 载 ， 这 样 一 共 是 36 个 方法 


























delete() 在 特定 的 URL 上 对 资源 执行 HTTP DELETE 操 作 


a 在 URL 上 执行 特定 的 HTTP 方 法 ， 返 回 包含 对 象 的 

E ResponseEntity， 这 个 对 象 是 从 响应 体 中 映射 得 到 的 

征 URL 上 执行 特定 的 HTTP 方 法 ， 返 回 一 个 从 响应 体 映射 得 到 的 对 
象 


、 发 送 一 个 HTTP GET 请 求 ， 返 回 的 ResponseEntity 包 含 了 响应 体 所 
getForEntity() 映射 成 的 对 象 


发 送 一 个 HTTP GET 请 求 ， 返 回 的 请 求 体 将 映射 为 一 个 对 象 
发 送 HTTP HEAD 请 求 ， 返 回 包 含 特定 资源 UREL 的 HTTP 头 















































发 送 HTTP OPTIONS 请 求 ， 返 回 对 特定 URE 的 Allow 头 信息 


ee POST 数据 到 一 个 URL， 返 回 包 含 一 个 对 象 的 ResponseEntity， 这 个 
postForEntity() | 对 象 是 从 响应 体 中 映射 得 到 的 

















os 所 到 一 人 URL， 返 加 根据 响应 人 匹配 开 成 的 对 全 
our 资源 到 竺 定 的 URL 


16.4.2 ”GET 资源 


你 可 能 意识 到 在 表 16.2 中 列 出 了 两 种 执行 GET 请 求 的 方 
法 : getForobject() 和 getForEntity()。  ， SE 
方法 又 有 三 种 形式 的 重 载 。 三 


<T> T getForObject(URI url, Class<T> responseType) 

















throws RestClientException; 
<T> T getForObject(String url, Class<T> responseType， 
Object... uriVariables) throws RestClientException; 
<T> T getForObject(String url, Class<T> responseType， 
Map<String, ?> uriVariables) throws RestClientException; 





类 似 地 ，getForEntity() 方 法 的 签名 如 下 : 


<T> ResponseEntity<T> getForEntity(URI url, Class<T> responseType) 
throws RestClientException; 
<T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, 


Object... uriVariables) throws RestClientException; 
<T> ResponseEntity<T> getForEntity(String url, Class<T> responseType, 
Map<String, ?> uriVariables) throws RestClientException; 





除了 返回 类 型 ，getForEntity() 方 法 就 是 getForObJject() 方 法 的 镜 
像 。 实 际 上 ， 它 们 的 工作 方式 大 同 小 异 。 它 们 都 执行 根据 URL 检 索 资 源 
的 GET 请 求 。 它 们 都 将 资源 根据 responseType 参 数 匹 配 为 一 定 的 类 
型 。 唯 一 的 区 别 在 于 getFor0bject() 只 返回 所 请 求 类 型 的 对 象 ， 

而 getForEntity() 方 法 会 返回 请 求 的 对 象 以 及 响应 相关 的 额外 信息 。 


让 我 们 首先 看 一 下 稍微 简单 的 getFor0bject() 方 法 。 然 后 再 看 看 如 何 
使 用 getForEntity() 方 法 来 从 GET 啊 应 中 获取 更 多 的 信息 。 

















16.4.3 ”检索 资源 


getForObject() 方 法 是 检索 资源 的 合适 选择 。 我 们 请 求 一 个 资源 并 按 
照 所 选择 的 Java 类 型 接收 该 资源 。 作 为 getForObject() 能 够 做 什么 的 
一 个 简单 示例 ， 让 我 们 看 一 下 fetchFacebookProfile() 的 另 一 个 实 
现 : 


public Profile fetchFacebookProfile(String id) { 
RestTemplate rest = new RestTemplate(); 


return rest.getForObject("http://graph.facebook.com/{spitter}", 
Profile.class, id); 








在 程序 清单 11.5 中 ，fetchFacebookProfile() 涉 及 十 多 行 代 码 。 通 过 
使 用 RestTemplate， 现 在 减少 到 了 几 行 (如 果 我 不 是 为 了 适应 本 书页 
面 的 边界 ， 可 能 会 更 少 ) 。 





fetchFacebookProfile() 首 先 构 建 了 一 个 RestTemplate 的 实例 ( 另 
一 种 可 行 的 方式 是 注入 实例 ) 。 接 下 来 ， 它 调用 了 getForobject() 来 
得 到 Facebook 个 人 信息 。 为 了 做 到 这 一 点 ， 它 要 求 结果 是 Profile 对 
象 。 在 接收 到 Profile 对 象 后 ， 该 方法 将 其 返回 给 调用 者 。 


注意 ， 在 这 个 新 版 本 的 fetchFacebookProfile () 中 ， 我 们 没有 使 用 
字符 串 连 接 来 构建 URL， 而 是 利用 了 RestTemplate 可 以 接受 参数 化 
URL 这 一 功能 。URL 中 的 {id} 占 位 符 最 终 将 会 用 方法 的 id 参 数 来 填 
充 。getForObject() 方 法 的 最 后 一 个 参数 是 大 小 可 变 的 参数 列表 ， 
个 参数 都 会 按 出 现 顺序 插入 到 指定 UREL 的 占 位 符 中 。 


另外 一 种 替代 方案 是 将 id 参数 放 到 Map 中 ， 并 以 id 作为 key， 然 后 将 这 
个 Map 作 为 最 后 一 个 参数 传递 给 getForObJject(): 














public Spittle[] fetchFacebookProfile(String id) { 
Map<String, String> urlVariables = new HashMap<String, String(); 
urlVariables.put("id", id); 


RestTemplate rest = new RestTemplate(); 
return rest.getForObject("http://graph.facebook.com/{spitter}", 
Profile.class, urlVariables); 





这 里 没有 任何 形式 的 JSON 解 析 和 对 象 映 射 。 在 表面 之 

下 ，getForObject( ) 为 我 们 将 响应 体 转换 为 对 象 。 它 实现 这 些 需要 依 
赖 表 16.1 中 所 列 的 HITP 消 息 转 换 器 ， 与 带 有 @ResponseBody 注 解 的 
Spring MVC 处 理 方法 所 使 用 的 一 样 。 


这 个 方法 也 没有 任何 异常 处 理 。 这 不 是 因为 getForObject() 不 能 抛 出 
异常 ， 而 是 因为 它 抛 出 的 异 弟 都 是 非 检 查 型 的 。 如 果 

在 getForobject() 中 有 错误 ， 将 抛 出 非 检查 型 RestClientException 
异常 〈 或 者 它 的 一 些 子 类 ) 。 如 果 愿 意 的 话 ， 你 可 以 捕获 它 一 但 编译 
器 不 会 强制 你 捕获 它 。 


16.4.4 ”抽取 啊 应 的 元 数据 


作为 getForObject( ) 的 一 个 痊 代 方案 ，RestTemplate 还 提供 了 

getForEntity()。getForEntity() 方 法 与 getForObject() 方 法 的 工 
作 很 相似 。getFor0bject() 只 返回 资源 (通过 HTTP 信 息 转 换 占 将 其 转 
换 为 Java 对 象 ) ，getForEntity() 会 在 ResponseEntity 中 返回 相同 的 








对 象 ， 而 且 ResponseEntity 还 带 有 关于 响应 的 额外 信息 ， 如 HITP 状 态 
码 和 响应 头 。 


我 们 可 能 想 使 用 ResponseEnt ity 所 做 的 事 葡 是 获取 啊 应 头 的 一 个 值 。 
例如 ， 假设 除了 获取 次 源 ， 还 想 要 知道 资源 的 最 后 修改 时 间 。 假 设 服务 
问 在 LastModified 头 部 信息 中 提供 了 这 个 信息 ， 我 们 可 以 这 样 像 这 样 
使 用 getHeaders() 方 法 : 


Date lastModified = new Date(response.getHeaders().getLastModified()); 


getHeaders() 方 法 返回 一 个 HttpHeaders 对 象 ， 该 对 象 提供 了 多 个 便 
利 的 方法 来 查询 响应 头 ， 包 括 getLastModified()， 它 将 返回 从 1970 
年 1 月 1 日 开始 的 宣 秒 数 。 


ee HttpHeaders 还 包含 如 下 的 方法 来 获取 头 


百 已 、 








List<MediaType> getAccept() { ... } 
List<Charset> getAcceptCharset() { ... 
Set<HttpMethod> getAllow() { ... } 
String getCacheControl() { ... } 
List<String> getConnection() { ... 
long getContentLength() { ... } 
MediaType getContentType() { ... } 
long getDate() { ... 

String getETag() { ... } 

long getExpires() { . } 

long petifNothod Piadsincet) {. 
List<String> getIfNoneMatch() 
long getLastModified() { ... } 

URI getLocation() { ... 

String getOrigin() { ... 

String getPragma() { ... 

String getUpgrade() { ... 








为 了 实现 更 通用 的 HTTP 头 信息 访问 ，HttpHeaders 提 供 了 get() 方 法 
和 BetFirst () 两 个 万 法 都 接受 string 参 数 米 标识 所 需要 的 头 信 
息 。get( ) 将 会 人 其 中 的 每 个 值 都 是 赋 给 该 头 
部 信息 的 ， 而 getFirst() 方 法 只 会 返回 第 一 个 头 信息 的 值 。 


如 果 你 对 啊 应 的 HTTP 状 态 码 感 兴趣 ， 那 么 你 可 以 调 





用 getSstatusCode() 方 法 。 例 如 ， 考 虑 下 面 这 个 获取 Spitt1le 对 象 的 方 
法 : 


public Spittle fetchSpittle(long id) { 
RestTemplate rest = new RestTemplate(); 
ResponseEntity<Spittle> response = rest.getForEntity( 
"http://localhost:860886/spittr-api/spittles/{id}", 
Spittle.class, id); 


if(response.getStatusCode() == HttpStatus.NOT MODIFIED) { 
throw new NotModifiedException(); 


} 


return response.getBody(); 


} 


在 这 里 ， 如 果 服 务 器 响应 304 状 态 ， 这 意味 着 服务 器 端的 内 容 自 从 上 一 
次 请 求 之 后 再 也 没有 修改 。 在 这 种 情况 下 ， 将 会 抛 出自 定 义 的 
NotModifiedException 有 异常 来 表明 客户 端 应 该 检查 它 的 绥 存 来 获取 
Spittle。 














16.4.5” PUT 资源 


为 了 对 数据 进行 PUT 操 作 ，RestTemplate 提 供 了 三 个 简单 的 put() 方 
法 。 就 像 其 他 的 RestTemp1late 方 法 一 样 ，put() 方 法 有 三 种 形式 : 


void put(URI url, Object request) throws RestClientException; 

void put(String url, Object request, Object... uriVariables) 
throws RestClientException; 

void put(String url, Object request, Map<String, ?> uriVariables) 
throws RestClientException; 





按照 它 最 简单 的 形式 ，put( ) 接 受 一 个 java.net.URI， 用 来 标识 (及 
定位 ) 要 将 资源 发 送 到 服务 器 上 ， 男 外 还 接受 一 个 对 象 ， 这 代表 了 资源 
的 Java 表 述 。 


例如 ， 以 下 展现 了 如 何 使 用 基于 URI 版 本 的 put( ) 方 法 来 更 新 服务 器 上 
的 Spittle 资 源 : 





public void updateSpittle(Spittle spittle) throws SpitterException { 
RestTemplate rest = new RestTemplate(); 
String url = "http://localhost:806088/spittr-api/spittles/" 
+ spittle.getId(); 


rest.put(URI.create(url), spittle); 
} 


在 这 里 ， 尽 管 方法 签名 很 简单 ， 但 是 使 用 java.net.URI 作 为 参数 的 影 
ee 为 了 创建 所 更 新 Spittle 对 象 的 URL， 我 们 要 进行 字符 串 拼 


从 getFor0bject() 和 getForEntity() 方 法 中 我 们 也 看 到 了 ， 使 用 基 
于 String 的 其 他 put() 方 法 能 够 为 我 们 减少 创建 URI 的 不 便 。 这 些 方法 
可 以 将 URI 指 定 为 模板 并 对 可 变 部 分 插入 值 。 以 下 是 使 用 基于 String 的 
put() 方 法 重 写 的 updateSpittle(): 


public void updateSpittle(Spittle spittle) throws SpitterException { 
RestTemplate rest = new RestTemplate(); 


rest.put("http://localhost:86806/spittr-api/spittles/{id}", 
spittle, spittle.getId()); 





现在 的 URI 使 用 简单 的 String 模板 来 进行 表示 。 当 RestTemplate 发 
送 PUT 请 求 时 ，URI 模 板 将 {id} 部 分 用 spittle.getId() 方 法 的 返回 值 
来 进行 蔡 换 。 就 像 getForObject() 和 getForEntity() 一 样 ， 这 个 版 
本 的 put() 方 法 最 后 一 个 参数 是 大 小 可 变 的 参数 列表 ， 每 一 个 值 会 出 现 
按照 顺序 赋值 给 占 位 符 变 量 。 


你 还 可 以 将 模板 参数 作为 Map 传 递 进 来 : 











public void updateSpittle(Spittle spittle) throws SpitterException { 
RestTemplate rest = new RestTemplate(); 
Map<String, String> params = new HashMap<String, String>(); 


params.put("id", spittle.getId()); 
rest.put("http://localhost:86806/spittr-api/spittles/{id}", 
spittle, params); 





当 使 用 Map 来 传递 模板 参数 时 ，Map 条 目的 每 个 key 值 与 URI 模 板 中 占 位 
符 变 量 的 名 字 相 同 。 


在 所 有 版 本 的 put() 中 ， 第 二 个 参数 都 是 表示 资源 的 Java 对 象 ， 它 将 按 
照 指 定 的 URI 发 送 到 服务 器 端 。 在 本 示例 中 ， 它 是 一 个 Spittle 对 
象 。RestTemplate 将 使 用 表 16.1 中 的 某 个 HTTP 消 息 转 换 器 将 Spittle 


对 象 转换 为 一 种 表述 形式 ， 并 在 请 求 体 中 将 其 友 送 到 服务 器 端 。 


对 象 将 被 转换 成 什么 样 的 内 容 类 型 很 大 程度 上 取决 于 传递 给 put( ) 方 法 
的 类 型 。 如 果 给 定 一 个 string 值 ， 那 么 将 会 使 

用 StringHttpMessageConverter: 这 个 值 直 接 被 写 到 请 求 体 中 ， 内 
容 类 型 设置 为 “text/plain”。 如 果 给 定 一 

个 MultiValueMapx<String,String>， 那 么 这 个 Map 中 的 值 将 会 被 
FormHttpMessageConverter 以 “app1Lication/x-www-form- 


urlencoded” 的 格式 写 到 请 求 体 中 。 


因为 我 们 传递 进来 的 是 Spittle 对 象 ， 所 以 需要 一 个 能 够 处 理 任意 对 象 
的 信息 转换 器 。 如 采 在 类 路 径 下 包含 Jackson 2 库 ， 那 

么 MappingJacksonHttpMessageConverter 将 以 application/json 
格式 将 Spittle 写 到 请 求 中 。 





16.4.6 DELETE 资源 


当 你 不 需要 在 服务 端 保留 某 个 资源 时 ， 那 么 可 能 需要 调 
用 RestTemplate 的 delete() 方 法 。 就 像 PUT 方 法 那样 ，delete() 方 法 
有 三 个 版 本 ， 它 们 的 签名 如 下 : 


void delete(String url, Object... uriVariables) 
throws RestClientException; 


void delete(String url, Map<String, ?> uriVariables) 
throws RestClientException; 
void delete(URI url) throws RestClientException; 





很 容易 吧 ，delete( ) 方 法 是 所 有 RestTemplate 方 法 中 最 简单 的 。 你 唯 
一 要 提供 的 就 是 要 删除 资源 的 URI。 例 如 ， 为 了 删除 指定 ID 的 
Spittle， 你 可 以 这 样 调用 delete(): 


public void deleteSpittle(long id) { 
RestTemplate rest = new RestTemplate(); 


rest.delete( 
URI.create("http://localhost:806806/spittr-api/spittles/" + id)); 





这 很 简单 ， 但 在 这 里 我 们 还 是 依赖 字符 串 连 接 来 创建 URI 对 象 。 所 以 ， 
我 们 再 看 一 个 更 简单 的 delete( ) 方 法 ， 它 能 够 使 得 我 们 人 免 于 这 些 抵 


烦 : 


public void deleteSpittle(long id) { 
RestTemplate rest = new RestTemplate(); 


rest.delete("http://localhost:8060806/spittr-api/spittles/{id}", id)); 
} 





你 看 ， 我 感觉 好 多 了 。 你 呢 ? 


现在 我 已 经 为 你 展现 了 最 简单 的 RestTemplate 方 法 ， 让 我 们 看 
看 RestTemplate 最 多 样 化 的 一 组 方法 一 一 它们 能 够 支持 HTTP POST 请 


16.4.7 POST 资 源 数 据 


在 16.2 节 的 表 中 ， 你 会 看 到 RestTemplate 有 三 个 不 同类 型 的 方法 来 发 
送 POST 请 求 。 当 你 再 乘 上 每 个 方法 的 三 个 不 同 变种 ， 那 就 是 有 九 个 方法 
来 POST 数据 到 服务 器 端 。 


这 些 方法 中 有 两 个 的 名 字 看 起 来 比较 类 似 。postForObject() 和 
postForEntity() 对 POST 请 求 的 处 理 方式 与 发 送 GET 请 求 的 
getForObject() 和 getForEntity() 方 法 是 类 似 的 。 男 一 个 方法 
是 getForLocation()， 它 是 POST 请 求 所 特有 的 。 

















16.4.8 ”在 POST 请 求 中 获取 啊 应 对 象 


假设 你 正在 使 用 RestTemplate 来 POST 一 个 新 的 Spitter 对 象 到 Spittr 
应 用 程序 的 REST API。 因 为 这 是 一 个 全 新 的 Spitter， 服 务 端 并 《还 ) 
不 知道 它 。 因 此 ， 它 还 不 是 真正 的 REST 资 源 ， 也 没有 URL。 另 外 ， 在 
服务 端 创建 之 前 ， 客 户 端 并 不 知道 Spitter 的 ID。 


POST 资源 到 服务 端的 一 种 方式 是 使 用 RestTemplate 的 
postForObject() 方 法 。postFor0bject() 方 法 的 三 个 变种 签名 如 
让 





<T> T postForObject(URI url, Object request, Class<T> responseType) 
throws RestClientException; 

<T> T postForObject(String url, Object request, Class<T> responseType, 
Object... uriVariables) throws RestClientException; 


<T> T postForObject(String url, Object request, Class<T> responseType, 
Map<String, ?> uriVariables) throws RestClientException; 

在 所 有 情况 下 ， 第 一 个 参数 都 是 资源 要 POST 到 的 URL， 第 二 个 参数 是 要 

发 送 的 对 象 ， 而 第 三 个 参数 是 预期 返回 的 Java 类 型 。 在 将 URL 作 

为 String 类 型 的 两 个 版 本 中 ， 第 四 个 参数 指定 了 URL 变 量 〈《 要 么 是 可 

变 参 数列 表 ， 要 么 是 一 个 Map) 。 


当 POST 新 的 Spitter 资 源 到 Spitter REST API 时 ， 它 们 应 该 发 送 

到 http:/localhost:8080/spittr-api/spitters， 这 里 会 有 一 个 应 对 POST 请 求 的 
处 理 方 法 来 保存 对 象 。 因 为 这 个 URL 不 需要 URL 参 数 ， 所 以 我 们 可 以 使 
用 任何 版 本 的 postForobject()。 但 为 了 保持 尽 可 能 简单 ， 我 们 可 以 
这 样 调 用 : 





public Spitter postSpitterForObject(Spitter spitter) { 
RestTemplate rest = new RestTemplate(); 


return rest.postForObject("http://localhost:806806/spittr-api/spitters", 
spitter, Spitter.class); 





postSpitterForObject() 方 法 给 定 了 一 个 新 创建 的 Spitter 对 象 ， 并 
使 用 postForobject() 将 其 发 送 到 服务 器 端 。 在 啊 应 中 ， 它 接收 到 一 
个 Spitter 对 象 并 将 其 返回 给 调用 者 。 


就 像 getForEntity() 方 法 一 样 ， 你 可 能 想得到 请 求 带 回来 的 一 些 元 数 
据 。 在 这 种 情况 下 ，postForEntity() 是 更 合适 的 方 

法 。postForEntity() 方 法 有 着 与 postForObject() 几 乎 相同 的 一 组 
签名 : 


<T> ResponseEntity<T> postForEntity(URI url, Object request, 
Class<T> responseType) throws RestClientException; 

<T> ResponseEntity<T> postForEntity(String url, Object request, 
Class<T> responseType, Object... uriVariables) 


throws RestClientException; 

<T> ResponseEntity<T> postForEntity(String url, Object request, 
Class<T> responseType, Map<String, ?> uriVariables) 
throws RestClientException; 





假设 除了 要 获取 返回 的 Spitter 资 源 ， 还 要 查看 响应 中 Location 头 信 
恩 的 值 。 在 这 种 情况 下 ， 你 可 以 这 样 调用 postForEntity(): 


RestTemplate rest = new RestTemplate(); 
ResponseEntity<Spitter> response = rest.postForEntity( 
"http://localhost:8060886/spittr-api/spitters", 


spitter, Spitter.class); 
Spitter spitter = response.getBody(); 
URI url = response.getHeaders().getLocation(); 





与 getForEntity() 方 法 一 样 ，postForEntity() 返 回 一 

个 ResponseEntity<T> 对 象 。 你 可 以 调用 这 个 对 象 的 getBody() 方 法 

以 获取 资源 对 象 〈 在 本 示例 中 是 Spitter) 。getHeaders() 会 给 你 一 

个 HttpHeaders， 通 过 它 可 以 访问 响应 中 返回 的 各 种 HTTP 头 信息 。 这 

里 ， 我 们 调用 getLocation() 来 得 到 java.net.URI 形 式 的 Location 头 


16.4.9 ”在 POST 请 求 后 获取 资源 位 置 


如 果 要 同时 接收 所 发 送 的 资源 和 啊 应 头 ，postForEntity() 方 法 是 很 

便利 的 。 但 通常 你 并 不 需要 将 资源 发 送 回来 (毕竟 ,将 其 发 送 到 服务 器 
端 是 第 一 位 的 ) 。 如 果 你 真正 需要 的 是 Location 头 信息 的 值 ， 那 么 使 

用 RestTemplate 的 postForLocation() 方 法 会 更 简单 。 


类 似 于 其 他 的 POST 方 法 ，postForLocation( ) 会 在 POST 请 求 的 请 求 体 
中 发 送 一 个 资源 到 服务 器 端 。 但 是 ， 响 应 不 再 是 相同 的 资源 对 

象 ，postForLocation( ) 的 啊 应 是 新 创建 资源 的 位 置 。 它 有 如 下 三 个 
方法 签名 : 





URI postForLocation(String url, Object request, Object... uriVariables) 
throws RestClientException; 
URI postForLocation( 


String url, Object request, Map<String, ?> uriVariables) 
throws RestClientException; 
URI postForLocation(URI url, Object request) throws RestClientException; 





为 了 展示 postForLocation()， 让 我 们 再 次 POST 一 个 Spitter。 这 
次 ， 我 们 希望 在 返回 中 包含 资源 的 URL: 





public String postSpitter(Spitter spitter) { 
RestTemplate rest = new RestTemplate(); 
return rest.postForLocation( 
"http://localhost:8060886/spittr-api/spitters", 


spitter).tostring(); 
} 


在 这 里 ， 我 们 以 String 的 形式 将 目标 URL 传 递 进 来 ， 还 有 要 POST 的 
Spitter 对 象 ( 在 本 示例 中 没有 URL 参 数 ) 。 在 创建 资源 后 ， 如 果 服 务 
端 在 响应 的 Location 头 信息 中 返回 新 资源 的 URL， 接 下 

来 postForLocation() 会 以 String 的 格式 返回 该 URL。 


16.4.10 ”交换 资源 


到 目前 为 止 ， 我 们 已 经 看 到 RestTemplate 的 各 种 方法 

来 GRT、PUT、DELETE 以 及 POST 资源 。 在 它们 之 中 ， 我 们 看 到 两 个 特殊 
的 方法 : getForEntity() 和 postForEntity()， 这 两 个 方法 将 结果 资 
源 包含 在 一 个 ResponseEntity 对 象 中 ， 通 过 这 个 对 象 我 们 可 以 得 到 啊 
应 头 和 状态 码 。 


能 够 从 啊 应 中 读 取 头 信息 是 很 有 用 的 。 但 是 如 果 你 想 在 发 送 给 服务 端的 
请 求 中 设置 涉 信 息 的 话 ， 怎 么 办 呢 ?” 这 束 是 RestTemplate 的 
exchange( ) 的 用 武之 地 。 


像 RestTemplate 的 其 他 方法 一 样 ，exchange() 也 重 载 为 三 个 签名 格 
式 。 一 个 使 用 java.net.URI 来 标识 目标 URL， 而 其 他 两 个 以 String 的 
形式 传 入 URL 并 带 有 URL 变 量 。 如 下 所 示 : 


























<T> ResponseEntity<T> exchange(URI url, HttpMethod method, 
HttpEntity<?> requestEntity, Class<T> responseType) 
throws RestClientException; 

<T> ResponseEntity<T> exchange(String url, HttpMethod method, 


HttpEntity<?> requestEntity, Class<T> responseType, 
Object... uriVariables) throws RestClientException; 
<T> ResponseEntity<T> exchange(String url, HttpMethod method, 
HttpEntity<?> requestEntity, Class<T> responseType, 
Mapx<String, ?> uriVariables) throws RestClientException; 





exchange( ) 方 法 使 用 HttpMethod 参 数 来 表明 要 使 用 的 HTTP 动 作 。 根 
0 exchange( ) 能 够 执行 与 其 他 RestTemplate 方 法 一 样 
工作 。 


例如 ， 从 服务 器 端 获取 Spitter 资 源 的 一 种 方式 是 使 用 RestTemplate 
的 getForEntity() 方 法 ， 如 下 所 示 : 


ResponseEntity<Spitter> response = rest.getForEntity( 
"http://localhost:806886/spittr-api/spitters/{spitter}", 


Spitter.class, spitterId); 
Spitter spitter = response.getBody(); 





在 下 面 的 代码 片段 中 ， 可 以 看 到 exchange() 也 可 以 完成 这 项 任务 : 


ResponseEntity<Spitter> response = rest.exchange( 
"http://localhost:806886/spittr-api/spitters/{spitter}", 


HttpMethod.GET, null, Spitter.class, spitterId); 
Spitter spitter = response.getBody(); 





通过 传 入 HttpMethod. GET 作 为 HTTP 动 作 ， 我 们 会 要 求 exchange() 发 
送 一 个 GET 请 求 。 第 三 个 参数 是 用 于 在 请 求 中 发 送 资 源 的 ， 但 因为 这 是 
一 个 GET 请 求 ， 它 可 以 是 nul1。 下 一 个 参数 表明 我 们 希望 将 响应 转换 

ee 最 后 一 个 参数 用 于 蔡 换 URL 模 板 中 {spitter} 占 位 符 


按照 这 种 方式 ， exehange( ) 3 /eet onEnt rty( /eb 
的 ， 但 是 ， 不 同 于 getForEntity( 
_ ”exchange() 方 法 允许 在 请 求 中 设置 头 信息 ， 接 下 来 ， 我 们 不 再 给 
exchange() 传 递 nul1， 而 是 传 入 带 有 请 求 头 信息 的 HttpEntity。 


人 exchange() 对 Spitter 的 GET 请 求 会 带 有 如 下 的 头 


品 DA 




















GET /Spitter/spitters/habuma HTTP/1.1 
Accept: application/xml, text/xml, application/*+xml, application/json 
Content-Length: 6 


User-Agent: Java/1.6.6 20 
Host: localhost:806806 
Connection: keep-alive 





让 我 们 看 一 下 Accept 头 信息 。 Accept 头 信息 表明 它 能 够 接受 多 种 不 同 
的 XML 内 容 类 型 以 及 application/json。 这 样 服务 器 由 
种 格式 返回 资源 时 ， 束 有 很 大 的 可 选 空间 。 0 
JSON 格 式 发 送 资 源 。 在 这 种 情况 下， 我们 需 
ee 的 唯一 值 。 





设置 请 求 头 信息 是 很 简单 的 ， 只 需 构 造 肥 送 给 exchange() 方 法 的 
HttpEntity 对 象 即 可 ，HttpEntity 中 包含 承载 头 信 息 的 
MultiValueMap: 


MultiValueMap<String, String> headers = 
new LinkedMultiValueMap<String, String>(); 


headers.add("Accept", "application/json"); 
HttpEntity<Object> requestEntity = new HttpEntity<Object>(headers); 





在 这 里 ， 我 们 创建 了 一 个 LinkedMultiValueMap 并 添加 值 

为 “application/json” 的 Accept 头 信息 。 接 下 来 ， 我 们 构建 了 一 
个 HttpEntity〔 使 用 0bject 泛 型 类 型 )， 将 MultiValueMap 作 为 构造 
参数 传 入 。 如 果 这 是 一 个 PUT 或 POST 请 求 ， 我 们 需要 为 HttpEntity 设 
置 在 请 这 这 是 没有 必要 的 。 


现在 ， 我 们 可 以 传 入 HttpEntity 来 调用 exchange(): 














ResponseEntity<Spitter> response = rest.exchange( 
"http://localhost:806886/spittr-api/spitters/{spitter}", 


HttpMethod.GET, requestEntity, Spitter.class, spitterId); 
Spitter spitter = response.getBody(); 








表面 上 看 ， 结 果 是 一 样 的 。 我 们 得 到 了 请 求 的 Spitter 对 象 。 但 在 表面 
之 下 ， 请 求 将 会 带 有 如 下 的 头 信息 发 送 : 


GET /Spitter/spitters/habuma HTTP/1.1 
Accept: application/json 
Content-Length: 6 


User-Agent: Java/1.6.6 20 
Host: localhost:806806 
Connection: keep-alive 





| en 啊 应 体 将 会 以 JSON 格 式 
来 进行 表述 


16.5 小结 


RESTful 淋 构 使 用 Web 标 准 来 集成 应 用 程序 ， 使 得 交互 变 得 简单 目 然 。 
系统 中 的 资源 采用 URL 进 行 标识 ， 使 用 HTTP 方 法 进行 管理 并 且 会 以 一 
种 或 多 种 适合 客户 端的 方式 来 进行 表述 。 


在 本 章 中 ， 我 们 看 到 了 如 何 编写 啊 应 RESTful 资 源 管理 请 求 的 Spring 
MVC 控 制 器 。 借 助 参数 化 的 URL 模 式 并 将 控制 器 处 理 方法 与 特定 的 
HTTP 方 法 关联 ， 控 制 器 能 够 啊 应 对 资源 的 GET、POST、PUT 以 及 
DELETE 请 求 。 


为 了 啊 应 这 些 请 求 ，Spring 能 够 将 资源 背后 的 数据 以 最 适合 客户 端的 形 

式 展现 。 对 于 基于 视图 的 响应 ，ContentNegotiatingViewResolver 

能 够 在 多 个 视图 解析 器 产生 的 视图 中 选择 出 最 适合 客户 端 期 望 内 容 类 型 
的 那 一 个 。 或 者 ， 控 制 器 的 处 理 方法 可 以 借助 ResponseBody 注 解 完 全 
红 过 视图 解析 ， 并 使 用 信息 转换 器 将 返回 值 转换 为 客户 端的 啊 应 。 


REST API 为 客户 闹 暴 露 了 应 用 的 功能 ， 它 们 眶 露 功 能 的 方式 恐怕 最 原 
始 的 API 设 计 者 做 梦 都 想不到 。REST API 的 客户 端 通常 是 移动 应 用 或 运 
行 在 Web 浏 览 器 中 的 JavaScript。 但 是 ，Spring 应 用 也 可 以 借助 
RestTemp1late 来 使 用 这 些 API。 


REST 只 是 应 用 间 通 信 的 方法 之 一 ， 在 下 一 章 中 ， 我 们 将 会 学 习 如 何在 
Spring 应 用 中 借助 消息 实现 异步 通信 。 














第 17 半 ”Spring 消 忌 
本 章 内 容 : 


。 异步 消息 简介 

。 基于 JMS 的 消息 功能 

。 使 用 Spring 和 AMQP 发 送 消息 
。 消息 驱动 的 POJO 


在 星期 五 下 午 4 点 55 分 ， 再 有 儿 分 钟 你 就 可 以 开始 休假 了 。 现 在 ， 你 的 
时 间 只 够 开车 到 机 场 赶 上 航班 了 。 但 是 在 你 打包 离开 之 前 ， 你 需要 确定 
老板 和 同事 了 解 你 目前 的 工作 进展 ， 这 样 他 们 就 可 以 在 星期 一 继续 完成 
你 留 下 的 工作 。 不 过 ， 你 的 一 些 同 事 已 经 提前 离开 过 周末 去 了 ， 而 你 的 
老板 正在 忙于 开会 。 你 该 上 怎么 办 呢 ? 


你 可 以 给 老板 打 电 话 ， 但 是 这 样 做 就 会 因为 一 个 不 重要 的 状态 报告 而 造 
成 不 必要 的 会 议 中 断 。 或 许 你 可 以 再 坚持 一 会 ， 等 到 会 议 结束 。 但 是 令 
人 郁闷 的 是 ， 你 根本 不 知道 会 议 还 要 持续 多 长 时 间 ， 而 你 又 要 赶 飞机 。 
和 
贴 在 一 起 。 


要 想 既 传达 到 你 的 工作 状态 又 能 在 上 飞机 ， 最 有 效 的 方式 就 是 发 送 一 封 
电子 邮件 给 你 的 老板 和 同事 ， 详 述 工作 进展 并 且 承 诺 给 他 们 寄 张 明 信 
片 。 你 不 知道 他 们 在 哪里 ， 也 不 知道 他 们 什么 时 候 才 能 真正 读 到 你 的 邮 
件 。 但 是 你 知道 ， 他 们 终 完 会 回 到 他 们 的 办 公园 劳 ， 阅 读 你 的 邮件 。 而 
此 时 ， 你 正在 赶 往 机 场 的 路 上 。 


有 些 时候 ， 需 要 直接 和 某 些 人 交谈 。 如 果 你 受伤 了 ， 需 要 救护 车 ， 你 可 
能 会 拿 起 电话 一 一 而 不 会 给 医院 发 电子 邮件 。 不 过 ， 在 通常 情况 下 ， 发 
送 消 奶 束 可 以 满足 要 求 ， 并 且 跟 直接 通信 相 比 更 具有 一 些 优 势 ， 例 如 可 
以 让 你 继续 你 的 假期 。 


在 前 面 的 一 些 章 中 ， 你 看 到 了 如 何 使 用 RMI、Hessian、Burlap、HITP 
invoker 和 Web 服 务 在 应 用 程序 之 间 进 行 通信 。 所 有 这 些 通信 机 制 都 是 同 
步 的 ， 客 户 端 应 用 程序 直接 与 远程 服务 相交 互 ， 并 且 一 直 等 到 远程 过 程 
































完成 后 才 继 续 执 行 。 


同步 通信 有 它 自 己 的 适用 场景 。 不 过 ， 对 于 开发 者 而 言 ， 这 种 通信 方式 

并 不 是 应 用 程序 之 间 进 行 交 互 的 唯一 方式 。 卉 步 消 恕 是 一 个 应 用 程序 问 

为 一 个 应 用 程序 间接 发 送 消息 的 一 种 方式 ， 这 种 方式 无 需 等 得 对 方 的 啊 

J 恩 ， 弄 步 消 轧 具 有 多 个 优势 ， 关 于 这 一 点 你 很 快 束 会 
| 。 


借助 Spring， 我 们 有 多 个 实现 异步 消息 的 可 选 方案 。 在 本 章 中 ， 我 们 将 
会 看 到 如 何在 Spring 中 使 用 Java 消 息 服 务 〈Java Message Service，JMS ) 
和 高 级 消息 队列 协议 〈Advanced Message Queuing Protocol，AMQP) 发 
送 和 接收 消 息 。 除 了 基本 的 消息 发 送 和 接收 之 外 ， 我 们 还 会 看 到 Spring 
对 消息 驱动 POJO 的 文 持 ， 它 是 一 种 与 EJB 的 消息 驱动 Bean (message- 
driven bean，MDB) 类 似 的 消息 接收 方式 。 

















17.1 异步 消息 简介 


与 前 面 几 章 中 介绍 的 远程 调用 机 制 以 及 REST 接 口 关 似 ， 并 步 消息 也 是 
用 于 应 用 程序 之 间 通 信 的 。 但 是 ， 在 系统 之 间 传 递 信息 的 方式 上 ， 它 与 
其 他 机 制 有 所 不 同 。 


像 RMI 和 Hessian/Burlap 这 样 的 远程 调用 机 制 是 同步 的 。 如 图 17.1 所 示 ， 
当 客 户 端 调用 远程 方法 时 ， 客 户 端 必须 等 到 远程 方法 完成 后 ， 才 能 继续 
服务 完成 。 


程序 
控制 流 


客户 端 





图 17.1 ”如 果 通信 和 是 同步 的 ， 客 户 端 必须 等 待 服务 完成 
消息 则 是 录 步 发 送 的 ， 如 图 17.2 所 示 ， 客 户 端 不 需要 等 待 服务 处 理 消 
息 ， 甚 至 不 需要 等 待 消息 投递 完成 。 客 户 端 发 送 消 妃 ， 然 后 继续 执行 ， 
这 是 因为 客户 端 假定 服务 最 终 可 以 收 到 并 处 理 这 条 消息 。 











程序 控制 流 


客户 端 不 
需要 等 待 














图 17.2 ”异步 通信 和 是 一 种 不 需要 等 待 的 通信 形式 


相对 于 同步 通信 ， 异 步 通 信和 具有 多 项 优势 ， 我 们 很 快 就 会 看 到 这 些 优 
点 。 但 是 首先 ， 让 我 们 看 看 如 何 异 步 发 送 消息 。 


17.1.1 发送 消息 


大 多 数 人 都 使 用 过 邮政 服务 。 每 天 会 有 数 百 万 信件 、 明 信 片 和 包 庄 交 到 
邮递 员 手 上 ， 我 们 相信 自己 邮寄 的 东西 会 被 送 到 目的 地 。 世 界 实在 是 大 
大 了 ， 我 们 无 法 自己 去 运送 这 些 东西 ， 因 此 我 们 依赖 邮政 系统 为 我 们 运 
送 。 我 们 在 信封 上 写 明 地 址 ， 贴 张 邮票 ， 接 着 把 它们 投 到 信箱 里 ， 而 不 
需要 考虑 信件 如 何 到 达 目 的 地 。 


邮政 服务 的 关键 在 于 间接 性 。 当 奶奶 的 生日 到 来 时 ， 如 果 我 们 直接 送 给 
她 一 张 而 卡 ， 这 非常 不 方便 。 我 们 必须 留 出 几 小 时 甚至 是 几 天 的 时 间 去 
为 她 送 生 日 痪 卡 ， 这 取决 于 她 住 哪里 。 符 运 的 是 ， 邮 局 可 以 将 站 卡 送 到 
奶奶 那里 ， 而 我 们 可 以 继续 上 自己 的 生活 。 


与 此 类 似 ， 间 接 性 也 是 异步 消 奶 的 关键 所 在 。 当 一 个 应 用 向 力 一 个 应 用 
发 送 消 轧 时 ， 两 个 应 用 之 间 没 有 直接 的 联系 。 相 反 的 是 ， 发 送 方 的 应 用 
0 6 
了 。 











在 异步 消息 中 有 两 个 主要 的 概念 : 消息 代理 〈message broker) 和 目的 
地 《〈destination) 。 当 一 个 应 用 发 送 消息 时 ， 会 将 消息 交 给 一 个 消息 代 
理 。 消 息 代 理 实际 上 类 似 于 邮局 。 消 息 代 理 可 以 确保 消息 被 投递 到 指定 





的 目的 地 ， 同 时 解放 发 送 者 ， 使 其 能 够 继续 进行 其 他 的 业务 。 


当 我 们 通过 邮局 邮递 信件 时 ， 最 重要 的 是 要 写 上 地 址 ， 这 样 邮局 就 可 以 
知道 这 封 信 应 该 被 投递 到 哪里 。 与 此 类 似 ， 每 条 异步 消息 都 带 有 一 个 目 
人 可 以 将 消息 放 入 这 个 邮箱 ， 直 到 有 人 将 
它们 取 走 。 


但 是 ， 并 不 像 信 件 地址 那样 必须 标识 特定 的 收 件 人 或 街道 地 址 ， 消 息 中 
的 目的 地 相对 来 说 并 不 那么 具体 。 目 的 地 只 关注 消息 应 该 从 哪里 获得 
一 一 而 不 关心 是 由 谁 取 走 消 奶 的 。 这 种 情况 下 ， 目 的 地 就 如 同 信件 的 地 
址 为 “本 地 居民 ”。 


尽管 不 同 的 消 恩 系统 会 提供 不 同 的 消 奶 路 由 模式 ， 但 是 有 两 种 通用 的 目 
的 地 :队列 queue〉 和 主题 (topic) 。 每 种 类 型 部 与 特定 的 消息 模型 
相关 联 ， 分 别 是 点 对 点 模型 (队列 ) 和 发 布 /订阅 模型 (主题)。 


点 对 点 消息 模型 


在 点 对 点 模型 中 ， 每 一 条 消 轧 都 有 一 个 用 送 者 和 一 个 接收 者 ， 如 图 17.3 
所 示 。 当 消息 代理 得 到 消 轧 时 ， 它 将 消 妃 放 入 一 个 队列 中 。 当 接收 者 请 
求 队列 中 的 下 一 条 消 思 时， 消息 会 从 队列 中 取出 ， 并 投递 给 接收 者 。 因 
人 
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图 17.3 ”消息 队列 对 消 妃 发 送 者 和 消 恩 接收 者 进行 了 解 耦 。 
虽然 队列 可 以 有 多 个 接收 者 ， 但 是 每 一 条 消息 只 能 被 一 个 接收 者 取 走 


管 消 息 队 列 中 的 每 一 条 消 妃 只 被 投递 给 一 个 接收 者 ， 但 是 并 不 意味 独 
能 使 用 一 个 接收 者 从 队列 中 获取 消 轧 。 事 实 上 ， 通 利 可 以 使 用 几 个 接 
和 不 过 ， 每 个 接收 者 都 会 处 理 目 己 所 接收 到 的 






































村 











这 与 在 银行 排队 等 候 类 似 。 在 等 待 时 ， 我 们 可 能 注意 到 很 多 银行 柜员 都 
可 以 帮助 我 们 处 理 金 融 业 务 。 在 柜员 帮助 客户 完成 业务 后 ， 她 就 空闲 
了 ， 此 时 ， 她 会 要 求 排队 等 候 的 下 一 个 人 前 来 办 理 业 务 。 如 果 我 们 排 在 


队伍 的 最 前 边 时 ， 我 们 就 会 被 叫 到 ， 然 后 由 其 中 的 一 个 空闲 柜员 来 帮助 
我 们 处 理 业 务 ， 而 其 他 的 柜员 则 会 帮助 其 他 的 银行 客户 。 


从 男 一 个 角度 看 ， 我 们 在 银行 排队 时 ， 并 不 知道 哪 一 个 柜员 会 帮助 我 们 
办 理 业 务 。 我 们 可 以 计算 队伍 中 有 多 少 人 ， 与 柜员 的 数目 进行 比较 ， 注 
意 哪 一 个 柜员 业务 办 理 速 有 度 最 快 ， 然 后 猜测 会 由 哪 一 个 柜员 办 理 我 们 的 
业务 。 但 是 ， 一 般 情 况 下 我 们 都会 猿 错 ， 最 终 会 由 力 一 个 柜员 来 办 理 。 


同样 ， 在 点 对 点 的 消 恩 中 ， 如 来 有 多 个 接收 者 监 昕 队列 ， 我 们 也 无 法 知 

道 某 条 特定 的 消 轧 会 由 哪 一 个 接收 者 处 理 。 这 种 不 确定 性 实际 上 有 很 多 
2 0 0 0 E 提 高 应 用 的 消 
和 处 理 能 


发 布 一 订阅 消 恩 模型 


在 发 布 一 订阅 消息 模型 中 ， 消 息 会 发 送 给 一 个 主题 。 与 队列 类 似 ， 多 个 

接收 者 都 可 以 监听 一 个 主题 。 但 是 ， 与 队列 不 同 的 是 ， 消 居 不 再 是 只 投 

nn 如 
17.4 及 未 。 
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图 17.4 ”与 队列 类 似 ， 主 题 可 以 将 消息 发 送 者 与 消 妃 接收 者 进行 解 簿 。 与 队列 
不 同 的 是 ， 主 题 消 息 可 以 发 送 给 多 个 主题 订阅 者 




















正如 它 的 名 字 所 暗示 的 ， 发 布 一 订阅 消息 模型 与 杂志 发 行商 和 杂志 订阅 
人 发 送 给 邮局 ， 然 后 所 有 的 订阅 者 都 会 
到 杂志 的 副本 。 


杂志 的 类 比 束 到 此 为 至 ， 因 为 对 于 寞 步 消息 来 讲 ， 友 布 者 并 不 知道 谁 订 
阅 了 它 的 消 轧 。 发 布 者 只 知道 它 的 消息 要 发 送 到 一 个 特定 的 主题 一 一 而 
人 
处 理 的 。 


现在 ， 我 们 已 经 介绍 了 异步 消息 的 基本 概念 ， 下 面 让 我 们 看 看 它 与 同步 
RPC 的 对 比 。 


17.1.2 ”评估 异步 消息 的 优点 


虽然 同步 通信 比较 容易 理解 ， 建 立 起 来 也 很 简单 ， 但 是 采用 同步 通信 机 
制 访问 远程 服务 的 客户 端 存在 儿 个 限制 ， 最 主要 的 是 : 


。 同步 通信 意味 着 等 待 。 当 客户 疹 调 用 远程 服务 的 方法 时 ， 它 必须 等 
待 远程 方法 结束 后 才能 继续 执行 。 如 果 客 户 病 与 远程 服务 频繁 通 

0 
Do] 。 

客户 站 通 过 服务 接口 与 远程 服务 相 厢 合 。 如 有 果 服 务 的 接口 及 生变 

化 ， 此 服务 的 所 有 客户 端 都 需要 做 相应 的 改变 。 

客户 并 与 远程 服务 的 位 置 灯 合 。 客 户 端 必须 配置 服务 的 网 络 位 置 ， 
这 样 它 才 知道 如 何 与 远程 服务 进行 交互 。 如 采 网 络 拓扑 进行 调整 ， 
客户 疹 也 需要 重新 配置 新 的 网 络 位 置 。 

客户 端 与 服务 的 可 用 性 相 耘 合 。 如 果 远 程 服务 不 可 用 ， 客 户 端 实际 
上 也 无 法 正常 运行 。 


里 然 同步 通信 仍然 有 它 的 适用 场景 ， 但 是 在 决定 应 用 程序 更 适合 哪 种 通 
信 机 制 时 ， 我 们 必须 考量 以 上 的 这 些 缺 点 。 如 果 这 些 限制 正 是 你 所 担心 
的 ， 那 你 可 能 很 想 知 道 民 步 通 信和 是 如 何 解决 这 些 问题 的 。 


无 需 等 竺 
当 使 用 JMS 发 送 消息 时 ， 客 户 端 不 必 等 待 消息 被 处 理 ， 甚 至 是 被 投递 。 
客户 端 只 需要 将 消息 发 送 给 消息 代理 ， 就 可 以 确信 消息 会 被 投递 给 相应 
的 目的 地 。 


因为 不 需要 等 待 ， 所 以 客户 端 可 以 继续 执行 其 他 任务 。 这 种 方式 可 以 有 
效 地 节省 时 间 ， 所 以 客户 端的 性 能 能 够 极 大 的 提高 。 
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面向 消息 和 解 耦 


与 面 癌 方 法 调用 的 RPC 通 信 不 同 ， 发 送 异 步 消息 是 以 数据 为 中 心 的。 这 
意味 着 客户 逆 并 没有 与 特定 的 方法 签名 绑 定 。 任 何 可 以 处 理 数据 的 队列 
或 主题 订阅 者 都 可 以 处 理由 客户 端 发 送 的 消 轧 ， 而 客户 端 不 必 了 解 远程 
服务 的 任何 规范 。 


位 置 独立 


同步 RPC 服 务 通常 需要 网 络 地 址 来 是 位。 这 意味 着 客户 端 无 法 灵活 地 适 
应 网 络 拓扑 的 改变 。 如 果 服 务 的 卫 地 址 改变 了 ， 或 者 服务 被 配置 为 监听 
其 他 端口 ， 客 户 端 必须 进行 相应 的 调整 ， 否 则 无 法 访问 服务 。 


与 之 相反 ， 消 息 客 户 端 不 必 知 道 谁 会 处 理 它 们 的 消息 ， 或 者 服务 的 位 置 
在 哪里 。 客 户 端 只 需要 了 解 需要 通过 哪个 队列 或 主题 来 发 送 消息 。 因 
此 ， 只 要 服务 能 够 从 队列 或 主题 中 获取 消 轧 即 可 ， 消 妃 客 户 端 根本 不 需 
要 关注 服务 来 自 哪 里 。 


在 反对 点 模型 中 ， 可 以 利用 这 种 位 置 的 独立 性 来 创建 服务 的 集群 。 如 果 
客户 端 不 知道 服务 的 位 置 ， 并 且 服 务 的 唯一 要 求 就 是 可 以 访问 消 恕 代 
理 ， 那 么 我 们 残 可 以 配置 多 个 服务 从 同一 个 队列 中 接收 消 恩 。 如 果 服 务 
过 载 ， 处 理 能 力 不 足 ， 我 们 只 需要 添加 一 些 新 的 服务 实例 来 监听 相同 的 
队列 就 可 以 了 。 


在 发 布 -订阅 模型 中 ， 位 置 独立 性 会 产生 男 一 种 有 趣 的 效应 。 多 个 服务 
可 以 订阅 同一 个 主题 ， 接 收 相 同 消 轧 的 副本 。 但 是 每 一 个 服务 对 消息 的 
处 理 逻 辑 却 可 能 有 所 不 同 。 例 如 ,假设 我 们 有 一 组 服务 可 以 共同 处 理 描 
述 新 员工 信息 的 消息 。 一 个 服务 可 能 会 在 工资 系统 中 增加 该 员工 ， 力 一 
个 服务 则 会 将 新 员工 增加 到 HR 门户 中 ， 同 时 还 有 一 个 服务 为 新 员工 分 
配 可 访问 系统 的 权限 。 每 一 个 服务 都 基于 相同 的 数据 《都 是 从 同一 个 主 
题 接收 的 ) ， 但 各 目 进 行 独立 的 处 理 。 


确保 投递 
为 了 使 客户 端 可 以 与 同步 服务 通信 ， 服 务必 须 监听 指定 的 耳 地 址 和 端 
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续 处 理 。 














但 是 ， 当 发 送 弄 步 消息 时 ， 客 己 端 完全 可 以 相信 消息 会 被 投递 。 即 使 在 
人 
用 为 止 。 


现在 ， 我 们 已 经 对 异步 消 妃 的 基础 知识 有 所 了 解 ， 接 下 来 看 一 下 如 何 将 
其 付 诸 实施 。 首先， 我 们 会 使 用 JMS 来 用 送 和 接收 消息 。 





17.2 ”使 用 JMS 发 送 消息 


Java 消 息 服 务 〈Java Message Service ，JMS ) 是 一 个 Java 标 准 ， 定 义 了 
使 用 消息 代理 的 通用 API。 在 JMS 出 现 之 前 ， 每 个 消息 代理 都 有 私有 的 
API， 这 就 使 得 不 同 代 理 之 间 的 消息 代码 很 难 通用 。 但 是 借助 JMS， 所 
有 遵从 规范 的 实现 都 使 用 通用 的 接口 ， 这 就 类 似 于 JDBC 为 数据 库 操 作 
提供 了 通用 的 接口 一 样 。 


Spring 通过 基于 模板 的 抽象 为 JMS 功 能 提供 了 支持 ， 这 个 模板 也 就 

是 JmsTemplate。 使 用 JmsTemplate， 能 够 非常 容易 地 在 消息 生产 方 发 
送 队 列 和 主题 消息 ， 在 消费 消息 的 那 一 方 ， 也 能 够 非常 容易 地 接收 这 些 
消息 。Spring 还 提供 了 消息 张 动 POJO 的 理念 : 这 是 一 个 简单 的 Java 对 
象 ， 它 能 够 以 异步 的 方式 响应 队列 或 主题 上 到 达 的 消息 。 


我 们 将 会 讨论 Spring 对 JMS 的 文 持 ， 包 括 JmsTemplate 和 消息 驱动 
POJO。 但 是 在 发 送 和 接收 消息 之 前 ， 我 们 首先 需要 一 个 消息 代理 ， 它 
能 够 在 消 上 县 的 生产 者 和 消费 者 之 间 传 递 消息 。 对 Spring JMS 的 探索 就 从 
在 Spring 中 搭建 消息 代理 开始 吧 。 


17.2.1 在 Spring 中 搭建 消息 代理 


ActiveMQ 是 一 个 伟大 的 开源 消息 代理 产品 ， 也 是 使 用 JMS 进 行 异步 消息 
传递 的 最 佳 选择 。 在 我 编写 本 书 的 时 候 ，ActiveMQ 的 最 新 版 本 为 
5.9.1。 在 开始 使 用 ActiveMQ 之 前 ， 我 们 需要 从 http:Wactivemq.apache.org 
下 载 二 进 制 发 行 包 。 下 载 完 ActiveMQ 后 ， 我 们 将 其 解压 缩 到 本 地 硬盘 
中 。 在 解压 目录 中 ， 我 们 会 找到 文件 activemq-core-5.9.1.jar。 为 了 能 够 
J 我 们 需要 将 此 JAR 文 件 添加 到 应 用 程序 的 类 路 径 




















在 bin 目 录 下 ， 我 们 可 以 看 到 为 各 种 操作 系统 所 创建 的 对 应 子 目 录 。 在 
这 些 子 目录 下 ， 我 们 可 以 找到 用 于 启动 ActiveMQ 的 脚本 。 例 如 ， 要 在 
OS X 下 启动 ActiveMQ， 我 们 只 需要 在 “bin/macosx” 目 录 下 运 

行 activemq start。 运 行 脚本 后 ，ActiveMQ 束 准备 好 了 ， 这 时 可 以 使 
用 它 作为 消息 代理 。 


创建 连接 工厂 


在 本 章 中 ， 我 们 将 了 解 如 何 采 用 不 同 的 方 2 Spinig th CHMAS 
接收 消 恩 。 在 所 有 的 示例 中 ， 我 们 都 需要 借助 JMS 连 接 工厂 通过 消息 代 
理发 送 消 轧 。 因 为 选择 了 ActiveMQ 作 为 我 们 的 消 妃 代理 ， 所 以 我 们 必 
须 配置 JMS 连 接 工 上 厂 ， 让 和 它 知 道 如 何 连 接 到 
ActiveMQ 。ActiveMQConnectionFactory 是 ActiveMQ 目 带 的 连接 工 
三 ， 在 Spring 中 可 以 使 用 如 下 方式 进行 配置 : 


<bean id="connectionFactory" 





class="org.apache.activemq.spring.ActiveMQConnectionFactory”/> 


默认 情况 下 ， eMC oe TONE OY | een eT 
localhost 的 61616 端 口 。 对 于 开发 环境 来 说 ， 这 没有 什么 问题 ， 但 是 在 生 
产 环境 下 ，ActiveMQ 可 能 会 在 不 同 的 主机 和 /端口 上 。 如 果 是 这 样 的 
话 ， 我 们 可 以 使 用 prokerURL 属 性 来 指定 代理 的 URL: 





<bean id="connectionFactory" 


class="org.apache.activemq.spring.ActiveMQConnectionFactory" 
p:brokerURL="tcp://localhost:61616"/> 








配置 连接 工厂 还 有 男 外 一 种 方式 ， 既 然 我 们 知道 正在 与 ActiveMQ 打 交 
道 ， 那 我 们 束 可 以 使 用 ActiveMQ 目 己 的 Spring 配置 命名 空间 来 声明 连接 
工厂 〈 适 用 于 ActiveMQ 4.1 之 后 的 所 有 版 本 ) 。 首 先 ， 我 们 必须 确保 在 
Spring 的 配置 文件 中 声明 了 amq 命 名 空间 : 


<?xml version="1.6” encoding="UTF-8"?> 

<beans xmlns="http://www.springframework.org/schema/beans" 

xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 

xmlns:jms="http://www.springframework.org/schema/jms" 

xmlns:amq="http://activemq.apache.org/schema/core" 

xsi:schemaLocation="http://activemq.apache.org/schema/core 
http://activemq.apache.org/schema/core/activemq-core.xsd 
http://www.springframework.org/schema/jms 
http://www.springframework.org/schema/jms/spring-jms.xsd 
http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 





</beans> 


现在 我 们 就 可 以 使 用 <amq:connectionFactory> 元 素 声明 连接 工厂 : 


<amq:connectionFactory id="connectionFactory" 





brokerURL="tcp://localhost:61616"/> 








注意 ，<amq:connectionFactory> 元 素 很 明显 是 为 ActiveMQ 所 准备 

的 。 如 果 我 们 使 用 不 同 的 消息 代理 实现 ， 它 们 不 一 定 会 提供 Spring 配 置 
命名 空间 。 如 果 没有 提供 的 话 ， 那 我 们 就 需要 使 用 <bean> 来 装配 连接 
四 本 类 


在 本 章 的 后 续 内 容 中 ， 我 们 会 多 次 使 用 connectionFactorybean， 但 
是 现在 ， 我 们 只 需要 通过 配置 brokerURL 属 性 来 告知 连接 工厂 消息 代理 
的 位 置 就 足够 了 。 在 本 例 中 ，brokerURL 属 性 中 的 URL 指 定 连 接 工厂 要 
连接 到 本 地 机 器 的 61616 端 口 〈 这 个 端口 是 ActiveMQ 监 听 的 默认 端口 ) 
上 的 ActiveMQ。 


声明 ActiveMQ 消 息 目 的 地 


除了 连接 工 广 外 ， 我 们 还 需要 消 妃 传递 的 目的 地 。 目 的 地 可 以 是 一 个 队 
列 ， 也 可 以 是 一 个 主题 ， 这 取决 于 应 用 的 需求 。 


不 论 使 用 的 是 队列 还 是 主题 ， 我 们 都 必须 使 用 特定 的 消息 代理 实现 类 在 
Spring 中 配置 目的 地 bean。 例 如 ， 下 面 的 <bean> 声 明定 义 了 一 个 
ActiveMQ 队 列 : 





id="queue" 


class="org.apache.activemq.command.ActiveMQQUeue" 
c: ="spitter.queue" /> 





同样 ， 下 面 的 <bean> 声 明定 义 了 一 个 ActiveMQ 主 题 : 


id="topic" 
class="org.apache.activemq.command.ActiveMQTopic" 





c: ="spitter.queue" /> 


在 第 一 个 示例 中 ， 构 造 器 指定 了 队列 的 名 称 ， 这 样 消息 代理 束 能 获知 该 
言 思 ， 而 在 接 下 来 示例 中 ， 名 称 则 为 spitter.topic。 


与 连接 工厂 相似 的 是 ，ActiveMQ 命 名 空间 提供 了 男 一 种 方式 来 声明 队 
列 和 主题 。 对 于 队列 ， 我 们 可 以 使 用 <amq :quence> 元 素来 声明 : 


<amq:queue id="spittleQueue" physicalName="spittle.alert.queue" /> 





如 果 是 JMS 主 题 ， 我 们 可 以 使 用 <amq:topic> 元 素来 声明 : 





<amq:topic id="spittleTopic" physicalName="spittle.alert.topic" /> 





不 管 是 哪 种 类 型 ， 都 是 借助 physicalName 属 性 指定 消息 通道 的 名 称 。 


到 此 为 止 ， 我 们 已 经 看 到 了 如 何 声明 使 用 JMS 所 需 的 组 件 。 现 在 我 们 已 
经 准备 好 发 送 和 接收 消息 了 。 为 此 ， 我 们 将 使 用 Spring 的 JmsTemp1late 
Spring 对 JMS 文 持 的 核心 部 分 。 但 是 首先 ， 让 我 们 先 看 看 如 果 没 
有 JmsTemplate，JMS 是 怎样 使 用 的 ， 以 此 了 解 JmsTemplate 到 底 提供 
了 些 什么 。 





17.2.2 ”使 用 Spring 的 JMS 模 板 


正如 我 们 所 看 到 的 ，JMS 为 Java 开 发 者 提供 了 与 消息 代理 进行 交互 来 友 
送 和 接收 消息 的 标准 API， 而 且 几 乎 每 个 消 妃 代理 实现 都 文 持 JMS， 
此 我 们 不 必 因 为 使 用 不 同 的 消息 代理 而 学 习 私 有 的 消 轧 API。 


里 然 JMS 为 所 有 的 消 奶 代理 提供 了 统一 的 接口 ， 但 是 这 种 接口 用 起 来 并 
不 是 很 方便 。 使 用 JMS 发 送 和 接收 消息 并 不 像 拿 一 张 邮票 并 贴 在 信封 上 
那么 简单 。 正 如 我 们 将 要 看 到 的 ，JMS 还 要 求 我 们 为 邮递 车 加 油 ( 只 是 
比喻 的 说 法 ) 。 


处 理 失 控 的 JMS 代 码 

在 10.3.1 小 市 中 ， 我 回 你 展示 了 传统 的 JDBC 代 码 在 处 理 连 接 、 语 句 、 结 
果 集 和 异常 时 是 多 么 见长 和 繁 茶 。 遗 憾 的 是 ， 传 统 的 JMS 使 用 了 类 似 的 
编程 模型 ， 如 下 面 的 程序 清单 所 示 。 


程序 清单 17.1 使 用 传统 的 JMS 〈 不 使 用 Spring) 发 送 消息 





9: /flocalhost:61616"); 










ion.createProducer (destination); 





reateTextMessagel(); 


producer Me sssage); 二 发 送 消息 
} ER (JMSExc "eption e) 
// handle maori on 
inally 
try { 
if 





再 次 声明 这 是 一 段 失 控 的 代码 ! 就 像 JDBC 示 例 一 样 ， 差 不 多 使 用 了 20 
行 代码 ， 只 是 为 了 友 送 一 条 “Hello world!” 消 息 。 实 际 上 ， 其 中 只 有 几 行 
Ne 发 送 消息 的 ， 剩 下 的 代码 仅仅 是 为 了 发 送 消息 而 进行 的 设 


接收 端 也 没有 好 到 哪里 去 ， 如 下 面 的 程序 清单 所 示 。 

与 程序 清单 17.1 一 样 ， 程 序 清 单 17.2 也 是 用 一 大 段 代 码 来 实现 如 此 简单 
的 事情 。 如 果 我 们 逐 行 地 比较 ， 我 们 会 发 现 它们 几乎 是 完全 一 样 的 。 如 
打 查 看 上 干 个 其 他 的 JMS 例 了 ， 我 们 会 发 现 它们 也 是 很 相似 的 。 只 不 


过 ， 其 中 一 些 会 从 JNDI 中 获取 连接 工厂 ， 而 男 一 些 则 是 使 用 主题 代 蔡 队 
列 。 但 是 无 论 如 何 ， 它 们 都 大 臻 遵循 相同 的 模式 。 


程序 清单 17.2 ”使 用 传统 的 JMS 〈 不 使 用 Spring) 接收 消息 




















ConnectionFactory cf = 
new ActiveMQConnectionFactory("tcp://localhost:61616"); 

Connection conn = null; 
Session session = null; 
try { 

conn = cf.createConnection(); 

conn.start(); 

session = conn.createSession(false, Session.AUTO ACKNOWLEDGE); 


Destination destination = 
new ActiveMQQueue("spitter.queue ") 


MessageConsumer consumer = session.createConsumer(destination); 
Message message = consumer.receivel(); 
TextMessage textMessage = (TextMessage) message; 
System.out.println("GOT A MESSAGE: ”+ textMessage.getText()); 
conn.start(); 

} catch (JMSException e) { 
// handle exception? 


} finally { 
try { 
if (session != null) { 
session.close() ; 
} 


if (conn != null) { 
conn.close(); 


} catch (JMSException ex) { 





因为 这 些 样 板式 代码 ， 我 们 每 次 使 用 JMS 时 都 要 不 断 地 做 很 多 重复 工 
作 。 更 糟糕 的 是 ， 你 会 发 现 我 们 在 重复 编写 其 他 开发 者 的 JMS 代 码 。 


我 们 已 经 在 第 10 章 看 到 了 Spring 的 JdbcTemplate 是 如 何 处 理 失 控 的 
JDBC 样 板式 代码 的 。 现 在 ， 让 我 来 介绍 一 下 Spring 的 JmsTemplate 如 何 
对 JMS 的 样板 式 代 码 实 现 相同 的 功能 。 


使 用 JMS 模 版 


针对 如 何 消除 宛 长 和 重复 的 JMS 代 码 ，Spring 给 出 的 解决 方案 
是 JmsTemplate。jmsTemplate 可 以 创建 连接 、 获 得 会 话 以 及 发 送 和 接 
收 消 轧 。 这 使 得 我 们 可 以 专注 于 构建 要 发 送 的 消息 或 者 处 理 接 收 到 的 消 


为 外 ，JmsTemplate 可 以 处 理 所 有 抛 出 的 笨拙 的 JMSException 异 常 。 
如 果 在 使 用 JmsTemplate 时 抛 出 JMSException 异 常 ，JmsTemplate 将 
捕获 该 异常 ， 然 后 抛 出 一 个 非 检查 型 异常 ， 该 异常 是 Spring 目 带 的 
JmsException 异 常 的 子 类 。 表 17.1 列 出 了 标准 的 JMSException 异 常 与 
Spring 的 非 检 查 型 异常 之 间 的 映射 关系 。 








表 17.1 Spring 的 JmsTemplate 会 捕获 标准 的 
JMSException 异 常 ， 再 以 Spring 的 非 检查 型 异常 JmsException 子 类 重新 抛 出 














T 








Spring (org.springframework.jms.*) 标准 的 JMS (javax.jms.*) 





: 二 > 。 w 二 各 如 《 
DestinationResolutionException a J Spring 励 法 解析 目的 地 名 
\ | 














IllegalStateException IllegalStateException 


InvalidClientIDException InvalidClientIDException 


InvalidDestinationException InvalidSelectorException 


InvalidSelectorException InvalidSelectorException 


JmsSecurityException JmsSecurityException 





Spring 特 有 的 当 监 听 器 方法 执行 失败 时 


ListenerExecutionFailedException 抛 出 














MessageConversionException Spring 特 有 的 一 一 当 消 息 转 换 失 败 时 抛 出 


MessageEOFException MessageEOFException 


MessageFormatException MessageFormatException 


MessageNotReadableException MessageNotReadableException 


MessageNotWriteableException MessageNotWriteableException 


ResourceAllocationException ResourceAllocationException 





SynchedLocalTransactionFailedException | Spring 特有 的 一 一 当 同 步 的 本 地 事务 不 能 完 
成 时 抛 出 


TransactionInprogressEXxception TransactionInprogressEXception 
TransactionRolledBackException TransactionRolledBackException 






































UncategorizedJmsException 





对 于 JMS API 来 说 ，JMSException 的 确 提供 了 丰富 且 具 有 描述 性 的 子 
类 集合 ， 让 我 们 更 清楚 地 知道 发 生 了 什么 错误 。 不 过 ， 所 有 的 
JMSException 寞 常 的 子 类 都 是 检查 型 异常 ， 因 此 必须 要 捕 

获 。JmsTemp1late 为 我 们 捕获 这 些 异 常 ， 并 重新 抛 出 对 应 非 检 查 型 
JMSException 和 异常 的 子 类 。 


为 了 使 用 JmsTemplate， 我 们 需要 在 Spring 的 配置 文件 中 将 它 声明 为 一 
个 bean。 如 下 的 XML 可 以 完成 这 项 工作 : 





<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" /> 





因为 JmsTemplate 需 要 知道 如 何 连接 到 消息 代理 ， 上 所 以 我 们 必须 

为 connection-Factory 属 性 设置 实现 了 JMS 的 ConnectionFactory 接 
口 的 bean 引 用 。 在 这 里 ， 我 们 使 用 在 12.2.1 小 节 中 所 声明 的 
connectionFactorybean 引 用 来 装配 该 属性 。 


这 就 是 配置 JmsTemplate 所 需要 做 的 所 有 工作 
经 准备 好 了 。 让 我 们 开始 发 送 消 轧 吧 ! 


发 送 消 旦 


在 我 们 想 建立 的 Spittr 应 用 程序 中 ， 其 中 有 一 个 特性 就 是 当 创 建 Spittle 的 
时 候 提醒 其 他 用 户 (或 许 是 通过 E-mail〉。 我 们 可 以 在 增加 Spittle 的 地 
方 直 接 实现 该 特性 。 但 是 搞 清楚 发 送 提醒 给 谁 以 及 实际 发 送 这 些 提醒 可 
能 需要 一 段 时 间 ， 这 会 影响 到 应 用 的 性 能 。 当 增加 一 个 新 的 Spittle 时 ， 


现在 JmsTemplate 已 








我 们 希望 应 用 是 敏捷 的 ， 能 够 快速 做 出 啊 应 。 


与 其 在 增加 Spittle 时 浪费 时 间 发 送 这 些 信 息 ， 不 如 对 该 项 工作 进行 排 
队 ， 在 啊 应 返回 给 用 户 之 后 再 处 理 它 。 与 直接 发 送 消 息 给 其 他 用 户 所 兹 
费 的 时 间 相 比 ， 发 送 消 轧 给 队列 或 主题 所 花费 的 时 间 是 微不足道 的 。 


为 了 在 Spittle 创 建 的 时 候 异 步 发 送 spittle 提 醒 ， 让 我 们 为 Spittr 应 用 引 
入 AlertService: 





package com.habuma.spittr.alerts; 
import com.habuma.spittr.domain.Spittle; 


public interface AlertService { 
void sendSpittleAlert(Spittle spittle); 
} 





正如 我 们 所 看 到 的 ，ALertService 是 一 个 接口 ， 只 定义 了 一 个 操作 
一 一 SendSpittleAlert() 。 


如 程序 清单 17.3 所 示 ，AlertserviceImp1 实 现 了 AlertSservice 接 口 ， 
它 使 用 Jmsoperation (JmsTemplate 所 实现 的 接口 ) 将 Spittle 对 象 
发 送 给 消息 队列 ， 而 队列 会 在 稍 后 得 到 处 理 。 


程序 清单 17.3 ”使 用 JmsTemplate 发 送 一 个 Spittle 





pringframework. jms .core .Jmsor 


org. springframework.jms.core.MessageCreator; 





import org 
import com.habuma.spittr.domain.Spittle; 


Public class AlertServiceImpl implements AlertService { 


private JmsOperations jmsOperations; 





rtServiceImpl (JmsOperations jmsOperatons) { - 注入 JMS 模板 


s.jmsOperations = jmsOperations; 


public void sendSpittleAlert (final Spittle spittle) { 


jmsOperations,.send!l < 发 送 消息 
"spittle.alert.queue", < 指定 目的 地 


new MessageCreator!) 
public Message createMessagelSession session) 
throws JMSException { 


return session.,createObjectMessage (spittle); < 创建 消息 
一 sev 





} 


JmsOperations 的 send() 方 法 的 第 一 个 参数 是 JMS 目 的 地 名 称 ， 标 识 
消息 将 发 送 给 谁 。 当 调用 send( ) 方 法 时 ，JmsTemplate 将 负责 获得 JMS 
连接 、 会 话 并 代表 发 送 者 发 送 消息 〈 如 图 17.5 所 示 ) 。 


d a 
王室 是 02 My 


图 17.5 ”JmsTemplate 代 表 发 送 者 来 负责 处 理发 送 消息 的 复杂 过 程 


我 们 使 用 MessageCreator〔 在 这 里 的 实现 是 作为 一 个 匿名 内 部 类 ) 来 
构造 消息 。 在 MessageCreator 的 createMessage() 方 法 中 ， 我 们 通过 
Session 创建 了 一 个 对 象 消息 : 传 入 一 个 Spitt1le 对 象 ， 返 回 一 个 对 象 消 


JU oO 


就 是 这 么 简单 ! 注意 ，sendSpittleAlert() 方 法 专注 于 组 装 和 发 送 消 
轧 。 在 这 里 没有 连接 或 会 话 管理 的 代码 ，JmsTemp1late 帮 我 们 处 理 了 所 
有 的 相关 事项 ， 而 且 我 们 也 不 需要 捕获 JMSException 异 

常 。JmsTemplate 将 捕获 抛 出 的 所 有 JMSException 异 常 ， 然 后 重新 抛 
出 表 17.1 所 列 的 某 一 种 非 检 查 型 异常 。 























设置 默认 目的 地 


在 程序 清单 17.3 中 ， 我 们 明确 指定 了 一 个 目的 地 ， 在 send() 方 法 中 将 
Spittle 消 息 发 问 此 目的 地 。 当 我 们 希望 通过 程序 选择 一 个 目的 地 时 ， 这 
种 形式 的 send() 方 法 很 适用 。 但 是 在 AlertServiceImp1 案 例 中 ， 我 们 
总 是 将 Spittle 消 息 发 给 相同 的 目的 地 ， 所 以 这 种 形式 的 send() 方 法 并 不 
能 带 来 明显 的 好 处 。 


与 其 每 次 发 送 消息 时 都 指 跑 一 个 目的 地 ， 不 如 我 们 为 JmsTemp1Late 装 配 
一 个 默认 的 目的 地 : 





<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" 
p:defaultDestinationName="spittle.alert.queue" /> 





在 这 里 ， 将 目的 地 的 名 称 设置 为 spittle.alert.queue， 但 它 只 是 一 
个 名 称 : 它 并 没有 说 明 你 所 处 理 的 目的 地 是 什么 类 型 。 如 果 已 经 存在 该 
名 称 的 队列 或 主题 的 话 ， 就 会 使 用 已 有 的 。 如 果 尚 未 存在 的 话 ， 将 会 创 
建 一 个 新 的 目的 地 〈 通 常会 是 队列 ) 。 但 是 ， 如 果 你 想 指定 要 创建 的 目 
那么 你 可 以 将 之 前 创建 的 队列 或 主题 的 目的 地 bean 装 配 


<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" 
p:defaultDestination-ref="spittleTopic" /> 





现在 ， 调 用 JmsTemplate 的 send() 方 法 时 ， 我 们 可 以 去 除 第 一 个 参数 
了 了 : 


jmsOperations .send( 
new MessageCreator() { 


); 





这 种 形式 的 send( ) 方 法 只 需要 传 入 一 个 MessageCreator。 因 为 希望 消 
息 发 送 给 默认 目的 地 ， 所 以 我 们 没有 必要 再 指定 特定 的 目的 地 。 





在 调用 send ( ) 方 法 时 ， 我 们 不 必 再 显 式 指定 目的 地 能 够 让 任务 得 以 简 
化 。 但 是 如 果 我 们 使 用 消息 转换 露 的 话 ， 发 送 消 妃 会 更 加 简单 。 


在 发 送 时 ， 对 消息 进行 转换 


除了 send() 方 法 ，JmsTemplate 还 提供 了 convertAndSend() 方 法 。 
与 send( ) 方 法 不 同 ，convertAndSend() 方 法 并 不 需要 
MessageCreator 作 为 参数 。 这 是 因为 convertAndsend() 会 使 用 内 置 
的 消息 转换 器 (message converter ) 为 我 们 创建 消息 。 


当 我 们 使 用 convertAndsend() 时 ，sendSspittleAlert() 可 以 减少 到 
方法 体 中 只 包含 一 行 代码 : 





public void sendSpittleAlert(Spittle spittle) { 
jmsOperations.convertAndSend(spittle); 


} 


就 像 变 魔术 一 样 ，Spittle 会 在 发 送 之 前 转换 为 Message。 不 过 就 像 所 
有 的 魔术 一 样 ，JmsTemp1late 内 部 会 进行 一 些 处 理 。 它 使 用 一 个 
MessageConverter 的 实现 类 将 对 象 转换 为 Message。 








MessageConverter 是 Spring 定 义 的 接口 ， 只 有 两 个 需要 实现 的 方法 : 


public interface MessageConverter { 
Message toMessage(Object object, Session session) 
throws JMSException, MessageConversionException; 


Object fromMessage(Message message) 
throws JMSException, MessageConversionException; 





尽管 这 个 接口 实现 起 来 很 简单 ， 但 我 们 通常 并 没有 必要 创建 自 定 义 的 实 
现 。Spring 已 经 提供 了 多 个 实现 ， 如 表 17.2 所 示 。 


表 17.2 ”Spring 为 通用 的 转换 任务 提供 了 多 个 消息 转换 器 
(所 有 的 消息 转换 器 都 位 于 org.springframework.jms.support.converter 包 中 


消息 转换 器 
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使 用 Jackson JSON 库 实现 消息 与 JSON 格 式 之 间 的 相 





MappingJacksonMessageConverter 


互 转换 





使 用 Jackson 2 JSON 库 实现 消息 与 JSON 格 式 之 间 的 
MappingJackson2MessageConverter 相互 转换 


有 JAXB 库 实现 消息 与 XML 格 式 之 间 的 相互 转换 




















实现 String 与 TextMessage 之 间 的 相互 转换 ， 字 节 数 
ee 组 与 BytesMessage 之 间 的 相互 转换 ，Map 与 MapMessage 
ee 之 间 的 相互 转换 以 及 serializable 对 象 
与 objectMessage 之 间 的 相互 转换 





默认 情况 下 ，JmsTemplate 在 convertAndSend() 方 法 中 会 使 

用 simpleMessage Converter。 但 是 通过 将 消息 转换 器 声明 为 bean 并 
将 其 注入 到 JmsTemplate 的 messageConverter 属 性 中 ， 我 们 可 以 重 写 
这 种 行为 。 例 如 ， 如 果 你 想 使 用 JSON 消 息 的 话 ， 那 么 可 以 声明 一 


个 MappingJacksonMessageConverter bean: 


<bean id="messageConverter" 
class="org.springframework.jms.support.converter.MappingJacksonMessag 





然后 ， 我 们 可 以 将 其 注入 到 JmsTemplate 中 ， 如 下 所 示 : 


<bean id="jmsTemplate" 
class="org.springframework.jms.core.JmsTemplate" 


c:_-ref="connectionFactory" 
p:defaultDestinationName="spittle.alert.queue" 
p:messageConverter-ref="messageConverter" /> 





各 个 消息 转换 器 可 能 会 有 额外 的 配置 ， 进 而 实现 转换 过 程 的 细 粒 度 控 
制 。 例 如 ，MappingJacksonMessageConverter 能 够 让 我 们 配置 转 码 
以 及 自 定义 Jackson 0bjectMapper。 可 以 查阅 每 个 消息 转换 器 的 
JavaDoc 以 了 解 如 何 更 加 细 粒 度 地 配置 它们 。 

接收 消息 


现在 我 们 已 经 了 解 了 如 何 使 用 JmsTemplate 发 送 消息 。 但 如 果 我 们 是 接 











收 端 ， 那 要 怎么 办 呢 ? JmsTemplate 是 不 是 也 可 以 接收 消息 呢 ? 


没 错 ， 的 确 可 以 。 事 实 上， 使 用 JmsTemplate 接 收 消息 甚至 更 简单 ， 我 
们 只 需要 调用 JmsTemplate 的 receive() 方 法 即 可 ， 如 程序 清单 12.4 所 
未。 

当 调 用 JmsTemplate 的 receive() 方 法 时 ，]JmsTemplate 会 尝试 从 消息 
代理 中 获取 一 个 消息 。 如 果 没 有 可 用 的 消息 ，receive() 方 法 会 一 直 等 
待 ， 直 到 获得 消息 为 止 。 图 17.6 展 示 了 这 个 交互 过 程 。 


程序 清单 17.4 使 用 JmsTemplate 接 收 消 息 











public Spittle receiveSpittleAlert(}) { 
try { 
ObjectMessage receivedMessage = 
(ObjectMessage) jmsOperations.receivel(); | 接收 消息 
获得 对 象 
抛 出 转换 
后 的 异常 















receive() 方 法 





JmsTemplate 


消息 接收 者 


图 17.6 ”使 用 JmsTemplate 从 主题 或 队列 中 接收 消息 的 时 候 ， 只 需要 简单 地 调用 receive() 方 法 。 
JmsTemplate 会 处 理 其 他 的 事情 


因为 我 们 知道 Spittle 消 息 是 作为 一 个 对 象 消 息 来 发 送 的 ， 所 以 它 可 以 在 
到 达 后 转型 为 0ObjectMessage。 然 后， 我 们 调用 get0bject() 方 法 把 
0bjectMessage 转 换 为 Spittle 对 象 并 返回 此 对 象 。 


但 是 这 里 存在 一 个 问题 ， 我 们 不 得 不 对 可 能 抛 出 的 JMSException 进 行 
处 理 。 正 如 我 已 经 提 到 的 ，JmsTemp1late 可 以 很 好 地 处 理 抛 出 的 
JmsException 检 查 型 异常 ， 然 后 把 异常 转换 为 Spring 非 检查 型 异 

常 ]JmsException 并 重新 抛 出 。 但 是 它 只 对 调用 JmsTemp1late 的 方法 时 
才 适 用 。JmsTemp1late 无 法 处 理 调用 ObjectMessage 的 getObject() 
方法 时 所 抛 出 的 JMSException 异 常 。 


因此 ， 我 们 要 么 捕获 JMSException 异 常 ， 要 么 声明 本 方法 抛 出 
JMSException 异 常 。 为 了 遵循 Spring 规 避 检 查 型 异常 的 设计 理念 ， 我 



































们 不 建议 本 方法 抛 出 JMSException 异 常 ， 所 以 我 们 选择 捕获 该 异常 。 
在 catch 代 码 块 中 ， 我 们 使 用 Spring 中 JmsUtils 的 
convertJmsAccessException() 方 法 把 检查 型 异常 JMSException 转 
换 为 非 检 查 型 异常 JjmsException。 这 其 实 是 在 其 他 场景 中 

由 JmsTemplate 为 我 们 做 的 事情 。 


在 receiveSspittleAlert() 方 法 中 ， 我 们 可 以 改善 的 一 点 束 是 使 用 消 
县 转换 器 。 在 convertAndSsend() 中 ， 我 们 已 经 看 到 了 如 何 将 对 象 转换 
为 Message。 不 过 ， 它 们 还 可 以 用 在 接收 问 ， 也 就 是 使 用 J]msTemplate 
的 receiveAndConvert(): 


public Spittle retrieveSpittleAlert() { 


return (Spittle) jmsOperations.receiveAndConvert(); 


} 





现在 ， 没 有 必要 将 Message 转 换 为 0bjectMessage， 也 没有 必要 通过 调 
用 getobject() 来 获取 Spittle， 更 无 需 担 心 检查 型 的 JMSException 
异常 。 这 个 新 的 retrieve SpittleAlert() 简 洁 了 许多 。 但 是 ， 依 然 
还 有 一 个 很 小 且 不 容易 察觉 的 问题 。 


使 用 JmsTemplate 接 收 消息 的 最 大 缺点 在 于 receive() 和 
receiveAndConvert() 方 法 都 是 同步 的 。 这 意味 着 接收 者 必须 耐心 等 
待 消 妃 的 到 来 ， 因 此 这 些 方法 会 一 直 被 阻塞 ， 直 到 有 可 用 消息 〈 或 者 直 
到 超时 ) 。 同 步 接收 异步 发 送 的 消 轧 ， 是 不 是 感觉 很 怪异 ? 


这 就 是 消息 驱动 POJO 的 用 武之 处 。 让 我 们 看 看 如 何 使 用 能 够 响应 消息 
的 组 件 异 步 接收 消息 ， 而 不 是 一 直 等 待 消息 的 到 来 。 


17.2.3 ”创建 消 明 驱动 的 POJO 


在 学 校 时 的 一 个 暑假 期 间 ， 我 得 到 了 在 黄石 国家 公园 工作 的 机 会 。 这 个 
工作 并 不 是 公园 巡逻 者 或 者 开关 老 忠 实 泉 (Old Faithful) 这 样 的 高 级 工 
作 ， 而 是 在 老 忠 实 凡 酒店 进行 更 换 床 单 、 清 理 卫 生 间 以 及 打扫 地 板 等 家 
虽然 不 是 很 吸引 人 ， 但 至 少 我 是 在 这 个 世界 上 最 美丽 的 地 方 工 


每 天 工作 之 后 ， 我 都 到 当地 的 邮局 看 看 是 否 有 我 的 邮件 。 我 已 经 离 家 好 
几 个 星期 了 了， 所 以 能 收 到 学 校 朋友 的 来 信 或 者 明信片 是 一 件 非常 美好 的 






































事情 。 我 没有 目 己 的 邮箱 ， 所 以 必须 走 着 去 邮局 ， 并 询问 坐 在 柜台 后 的 
工作 人 员 是 否 有 我 的 邮件 。 接 着 束 是 开始 等 生 。 


要 知道 ， 柜 台 后 的 那个 人 大 约 有 195 岁 了 。 像 他 这 个 岁数 的 人 ， 走 动 
起 来 很 费时 间 。 他 从 椅子 上 站 起 来 ， 慢 慢 走 过 地 板 ， 消 失 在 隔 增 后 。 过 
了 了 一会儿， 他 出 现 了 ， 慢 慢 回 到 柜台 ， 华 到 椅子 上 ， 然 后 看 着 我 

说 ;“ 今 天 没有 邮件 ”。 


JmsTemplate 的 receive() 方 法 与 这 个 上 了 年 纪 的 邮局 雇员 很 像 。 当 我 
们 调用 receive( ) 方 法 时 ，JmsTemplate 会 查看 队列 或 主题 中 是 否 有 消 
上 ， 直 到 收 到 消息 或 者 等 竺 超时 才 会 返回 。 这 期 间 ， 应 用 无 法 处 理 任 何 
事情 ， 只 能 等 竺 是 否 有 消息 。 如 果 应 用 能 够 继续 进行 其 他 业务 处 理 ， 当 
消息 到 达 时 再 去 通知 它 ， 不 是 更 好 吗 ? 


EJB2 规 范 的 一 个 重要 内 容 是 引入 了 消息 驱动 bean (message-driven 
bean，MDB) 。MDB 是 可 以 异步 处 理 消息 的 EJB。 换 句 话说 ，MDB 将 
JMS 目 的 地 中 的 消息 作为 事件 ， 并 对 这 些 事件 进行 啊 应 。 而 与 之 相反 的 
是 ， 同 步 消息 接收 者 在 消息 可 用 前 会 一 直 处 于 阻塞 状态 。 


MDB 是 EJB 中 的 一 个 亮点 。 即 使 那些 狂热 的 EJB 反 对 者 也 认为 MDB 可 以 
优雅 地 处 理 消 息 。EJB 2 MDB 的 唯一 缺点 是 它们 必须 要 实现 
java.ejb.MessageDriven-Bean。 此 外 ， 它 们 还 必须 实现 一 些 EJB 生 
命 周 期 的 回调 方法 。 简 而 言 之 ，EJB 2 MDB 不 是 纯 的 POJO。 


在 EJB 3 规范 中 ，MDB 进 一 步 简 化 了 ， 使 其 更 像 POJO。 我 们 不 再 需要 实 
现 MessageDrivenBean 接 口 ， 而 是 实现 更 通用 的 
javax.Jjms.MessageListener 接 口 ， 并 使 用 QMessageDriven 注 解 标 
注 MDB。 


Spring 2.0 提 供 了 它 自己 的 消息 驱动 bean 来 满足 异步 接收 消息 的 需求 ， 这 
种 形式 与 EJB 3 的 MDB 很 相似 。 在 本 节 中 ， 我 们 将 学 习 到 Spring 是 如 何 
使 用 消息 驱动 POJO〔 我 们 将 其 简称 为 MDP〉 来 支持 异步 接收 消息 的 。 


创建 消息 监听 器 
如 果 使 用 EJB 的 消息 驱动 模型 来 创建 Spittle 的 提醒 处 理 器 ， 我 们 需要 使 


用 @MessageDriven 注 解 进行 标注 。 即 使 它 不 是 严格 要 求 的 ， 但 EJB 规 
范 还 是 建议 MDB 实 现 MessageListener 接 口 。Spittle 的 提醒 处 理 器 最 终 
































可 能 是 这 样 的 : 


ZI 
EC 
讨 


@MessageDriven(mappedName="jms/spittle.alert.queue") 

public class SpittleAlertHandler implements MessageListener { 
@Resource 
private MessageDrivenContext mdc ; 


public void onMessage(Message message) { 


} 
} 


想象 一 下 ， 如 果 消 息 驱 动 组 件 不 需要 实现 MessageListener 接 口 ， 世 
界 将 是 多 么 的 简单 。 在 这 里 ， 天 是 兰 蓝 的 ， 乌 儿 唱 着 我 们 喜欢 的 歌 ， 我 
们 不 再 需要 实现 onMessage() 方 法 或 者 注入 Messge DrivenContext。 


好 吧 ， 可 能 EJB 3 规范 所 要 求 的 MDB 也 算 不 上 太 麻 烦 。 但 是 事实 

上 ，SpittleAlertHandler 的 EJB 3 实现 太 依赖 于 EJB 的 消息 驱动 AP1， 
并 不 是 我 们 所 希望 的 POJO。 理 想 情 况 下 ， 我 们 希望 提醒 处 理 器 能 够 处 
理 消息 ， 但 是 不 用 编码 ， 就 好 像 它 知道 应 该 做 什么 。 

Spring 提 供 了 以 POJO 的 方式 处 理 消 息 的 能 力 ， 这 些 消 息 来 自 于 JMS 的 队 
列 或 主题 中 。 例 如 ， 基 于 POJO 实 现 spittleAlertHandler 就 足以 做 到 
这 


程序 清单 17.5” ”Spring MDP 异 步 接收 和 处 理 消息 








package com.habuma.spittr.alerts; 


import com.habuma.spittr.domain.Spittle:; 





leAlert (Spittle spittle) { a 处 理 方 法 


虽然 改变 天 空 的 颜色 和 训练 乌 儿 歌唱 超出 了 Spring 的 范围 ， 但 程序 清单 
17.5 所 展示 的 现实 与 我 描绘 的 理想 世界 非常 接近 。 我 们 稍 后 会 编写 
handleSpittleAlert() 方 法 的 具体 内 容 。 现 在 ， 程 序 清单 17.5 所 展示 
的 SpittleAlertHandler 没 有 任何 JMS 的 痕迹 。 从 任意 一 个 角度 观 
察 ， 它 都 是 一 个 纯粹 的 POJO。 它 仍然 可 以 像 EJB 那 样 处 理 消 轧 ， 只 不 过 
它 还 需要 一 些 Spring 的 配置 。 


配置 消 轧 监听 喜 


为 POJO 赋 予 消息 接收 能 力 的 诀 穹 是 在 Spring 中 把 它 配置 为 消 轧 监听 器 。 
Spring 的 jms 命名 空间 为 我 们 提供 了 所 需要 的 一 切 。 首 先 ， 让 我 们 移 把 
处 理 器 声明 为 bean: 


<bean id="spittleHandler" 


class="com.habuma.spittr.alerts.SpittleAlertHandler" /> 





然后 ， 为 了 把 spittleAlertHandler 转 变 为 消息 驱动 的 POJO， 我 们 震 
要 把 这 个 bean 声 明 为 消息 监听 占 : 


<jms:listener-container connection-factory="connectionFactory"> 
<jms:listener destination="spitter.alert.queue" 
ref="spittleHandler" method="handleSpittleAlert" /> 
</jms:1listener-container> 








在 这 里 ， 我 们 在 消 四 监 听 器 容器 中 包含 了 一 个 消息 监听 器 。 消 轧 监 听 器 
容器 《message listener container) 是 一 个 特殊 的 bean， 它 可 以 监控 JMS 
目的 地 并 等 得 消 奶 到 达 。 一 旦 有 消 奶 到 达 ， 它 取出 消 轧 ， 然 后 把 消 轧 传 
给 任意 一 个 对 此 消息 感 兴趣 的 消息 监听 器 。 如 图 17.7 展 示 了 这 个 交互 过 
程 。 


| 消息 监 由 消息 监听 器 


图 17.7 ”消息 监听 器 容器 监听 队列 和 主题 。 
当 消 息 到 达 时 ， 消 息 将 转 给 消息 监听 器 〈 例 如 消息 驱动 的 POJO ) 


为 了 在 Spring 中 配置 消息 监听 器 容器 和 消息 监听 器 ， 我 们 使 用 了 Spring 
jms 命名 空间 中 的 两 个 元 素 。<jms:1istener-container> 中 包含 了 
<jms:1istener> 元 素 。 这 里 的 connection-factory 属 性 配置 了 对 
connectionFactory 的 引用 ， 容 器 中 的 每 个 <jms:1istener> 都 使 用 这 
个 连接 工厂 进行 消息 监听 。 在 本 示例 中 ，connection-factory 属 性 可 
以 移 除 ， 因 为 该 属性 的 默认 值 就 是 connectionFactory。 


对 于 <jms :1istener> 元 素 ， 它 用 于 标识 一 个 bean 和 一 个 可 以 处 理 消 筷 
的 方法 。 为 了 处 理 Spittle 提 醒 消 息 ，ref 元 素 引 用 了 spittleHandler 
bean。 当 消息 到 达 spitter.alert.queue 队 列 ( 通 过 destination 属 


























性 配置 ) 时 ，spittleHandlerbean 的 handleSpittleAlert() 方 法 
(通过 method 属 性 指定 的 ) 会 被 触发 。 


值得 一 提 的 是 ， 如 果 ref 属 性 所 标示 的 bean 实 现 了 MessageListener， 
那 就 没有 必要 再 指定 method 属 性 了 ， 默 认 束 会 调用 onMessage() 方 
二 


17.2.4 ”使 用 基于 消息 的 RPC 


在 第 15 章 中 ， 我 们 展示 了 Spring 把 bean 的 方法 暴露 为 远程 服务 以 及 从 客 
户 端 向 这 些 服务 发 起 调用 的 几 种 方式 。 在 本 章 ， 我 们 学 习 了 如 何 通过 队 
列 和 主题 在 应 用 程序 之 间 发 送 消息 。 现 在 我 们 将 了 解 一 下 如 何 使 用 JMS 
作为 传输 通道 来 进行 远程 调用 。 


为 了 文 持 基 于 消息 的 RPC，Spring 提 供 了 
JmsInvokerserviceExporter， 它 可 以 把 bean 导 出 为 基于 消息 的 服 
务 ; 为 客户 端 提 供 了 JmsInvokerProxyFactoryBean 来 使 用 这 些 服 
务 。 








让 我 们 回顾 一 下 第 15 章 ，Spring 提 供 了 多 种 方式 把 bean 导 出 为 远程 服 
务 。 我 们 使 用 RmiServiceExporter 把 bean 导 出 为 RMI 服 务 ， 使 

用 HessianExporter 和 BurlapExporter 导 出 为 基于 HTTP 的 Hessian 和 
Burlap 服 务 ， 还 使 用 HttpInvoker Service Exporter 创 建 基 于 HTTP 
的 HITP invoker 服 务 。 但 Spring 还 提供 了 一 种 在 第 15 章 中 我 们 未 探讨 的 
服务 导出 器 。 


导出 基于 JMS 的 服务 
JmsInvokerServiceExporter 很 类 似 于 其 他 的 服务 导出 细 。 事 实 


上 ,JmsInvoker-ServiceExporter 


与 HttpInvokerServiceExporter 在 名 称 上 有 某 种 对 称 型 。 如 果 
HttpInvokerServiceExporter 可 以 导出 基于 HTTP 通 信 的 服务 ， 那 
么 JmsInvoker-ServiceExporter 就 应 该 可 以 导出 基于 JMS 的 服务 。 


为 了 演示 JmsInvokerServiceExporter 是 如 何 工 作 的 ， 考 虑 如 下 的 
AlertServiceImpl。 


程序 清单 17.6。”AlertServiceImpl 是 一 个 处 理 JMS 消 息 的 POJO， 但 是 不 


依赖 于 JMS 


package com.habuma.spittr.alerts; 






rt org.springfrs rk.mail.SimpleMailMessage; 






rt org.springframework.mail.javamail .JavaMailSender; 
rt org.springframework.stereotype.Component; 
import com.habuma.spittr.domain.SsSpittle; 
&Component ("alertService") 
public class AlertServiceImpl implements AlertService { 
private JavaMailSender mailSender; 
private String alertEmailAddress; 


public AlertServiceImpl (JavaMailSender mailsSender, 


String alertEmailAddress) { 


this.mailSender = mailSender; 
this.alertEmailAddress = alertEmailAddress; 


ittle spittle) { < 一 发 送 Spittle 提醒 
lMessage!(); 






er1) .getFullName{}); 





stTo(alertEmailAddress); 






ge.setSubject{("New spittle from " + spitterName); 
message.setText (spitterName + " says: " + spittle.getText()); 


mailSsSender.sendlmessage); 
} 





我 们 现在 不 要 过 于 关注 sendSpittleAlert() 方 法 的 细节 。 在 第 19 章 ， 

我 们 将 会 继续 探讨 如 何 使 用 Spring 发 送 E-mail。 现 在 ， 我 们 需要 关注 的 

重点 在 于 AlertServiceImpl 是 一 个 简单 的 POJO， 没 有 任何 迹象 标示 它 
要 用 来 处 理 JMS 消 息 。 它 只 是 实现 了 简单 的 AlertService 接 口 ， 该 接 

口 如 下 所 示 : 





package com.habuma.spittr.alerts; 
import com.habuma.spittr.domain.Spittle; 


public interface AlertService { 
void sendSpittleAlert(Spittle spittle); 
} 





正如 我 们 所 看 到 的 ，AlertServiceImpl 使 用 了 @Component 注 解 来 标 
注 ， 所 以 它 会 被 Spring 自动 友 现 并 注册 为 Spring 应 用 上 下 文中 ID 

为 alertService 的 bean。 在 配置 ]JmsInvokerServiceExporter 时 ， 
我 们 将 引用 这 个 bean: 





<bean id="alertServiceExporter" 
class="org.springframework.jms.remoting.JmsInvokerServiceExporter" 
p:service-ref="alertService" 


p:serviceInterface="com.habuma.spittr.alerts.AlertService" /> 





这 个 bean 的 属性 描述 了 导出 的 服务 应 该 是 什么 样子 的 。service 属 性 设 
置 为 alertServicebean 的 引用 ， 它 是 远程 服务 的 实现 。 同 
serviceInterface 属 性 设置 为 远程 服务 对 外 提供 接口 的 全 限定 类 





导出 堪 的 属性 并 没有 摘 述 服务 如 何 基 于 JMS 通 信 的 细节 。 但 好 消息 
是 JmsInvokerServiceExporter 可 以 充当 JMS 监 昕 器 。 因 此 ， 我 们 使 
用 <jms:1listenercontainer> 元 素 配 置 它 : 


<jms:listener-container connection-factory="connectionFactory"> 
<jms:listener destination="spitter.alert.queue" 


ref="alertServiceExporter" /> 
</jms:listener-container> 





我 们 为 JMS 监 听 器 容器 指定 了 连接 工厂 ， 所 以 它 能 够 知道 如 何 连接 消息 
代理 ， 而 <jms :listener> 声 明 指 定 了 远程 消息 的 目的 地 。 


使 用 基于 JMS 的 服务 
这 时 候 ， 基 于 JMS 的 提醒 服务 已 经 准备 好 了 ， 等 待 队列 中 名 字 


为 spitter.alert.queue 的 RPC 消 息 到 达 。 在 客户 
端 ，JmsInvokerProxyFactoryBean 用 来 访问 服务 。 








JmsInvokerProxyFactoryBean 很 类 似 于 我 们 在 第 15 章 中 所 讨论 的 其 
他 远程 代理 工厂 bean。 它 隐藏 了 访问 远程 服务 的 细节 ， 并 提供 一 个 易 用 
的 接口 ， 通 过 该 接口 客户 端 与 远程 服务 进行 交互 。 与 代理 RMI 服 务 或 

HTTP 服 务 的 最 大 区 别 在 于 ，JmsInvokerProxy-FactoryBean 人 代理 了 
通过 JmsInvokerServiceExporter 所 导出 的 JMS 服 务 。 


为 了 使 用 提醒 服务 ， 我 们 可 以 像 下 面 那样 配 


置 JmsInvokerProxyFactoryBean: 








<bean id="alertService" 
class="org.springframework.jms.remoting.JmsInvokerProxyFactoryBean" 


p:connectionFactory-ref="connectionFactory" 
p:queueName="spittle.alert.queue" 
propp:serviceInterface="com.habuma.spittr.alerts.AlertService" /> 





connectionFactory 和 queryName 属 性 指定 了 RPC 消 息 如 何 被 投递 一 一 
在 这 里 ， 也 就 是 在 给 定 的 连接 工厂 中 ， 我 们 所 配置 的 消息 代理 里 面 名 为 
spitter.alert.queue 的 队列 。 对 于 serviceInterface， 指 定 了 代理 应 该 通 
过 AlertService 接 口 暴 露 功能 。 


多 年 来 ，JMS 一 直 是 Java 应 用 中 主流 的 消息 解决 方案 。 但 是 对 于 Java 和 
Spring 开发 者 来 说 ，JMS 并 不 是 唯一 的 消息 可 选 方案 。 在 过 去 的 几 年 
中 ， 高 级 消息 队列 协议 (Advanced Message Queuing Protocol ， 
AMQP) 得 到 了 广泛 的 关注 。 因 此 ，Spring 也 为 通过 AMQP 发 送 消息 提 
供 了 文 持 ， 这 融 是 我 们 下 面 要 讲解 的 内 容 。 








17.3 ”使 用 AMQP 实 现 消 息 功 能 


你 可 能 会 疑惑 为 什么 还 需要 兄 外 一 个 消 妃 规范 。 难 道 JMS 还 不 够 好 吗 ? 
AMQP 提 供 了 哪些 JMS 所 不 具备 的 特性 呢 ? 


实际 上 ，AMQP 有 具有 多 项 JMS 所 不 有 具备 的 优势 。 首 先 ，AMQP 为 消息 定 
义 了 线路 层 (wire-level protocol) 的 协议 ， 而 JMS 所 定义 的 是 API 规 范 。 
JMS 的 API 协 议 能 够 确保 所 有 的 实现 都 能 通过 通用 的 API 来 使 用 ， 但 是 并 
不 能 保证 某 个 JMS 实 现 所 发 送 的 消息 能 够 被 另外 不 同 的 JMS 实 现 所 使 
用 。 而 AMQP 的 线路 层 协 议 规 范 了 消息 的 格式 ， 消 息 在 生产 者 和 消费 者 
间 传 送 的 时 候 会 遵循 这 个 格式 。 这 样 AMQP 在 互相 协作 方面 就 要 优 于 
JMS 一 一 它 不 仅 能 跨 不 同 的 AMQP 实 现 ， 还 能 跨 语言 和 平台 。[9 


相 比 JMS，AMQP 男 外 一 个 明显 的 优势 在 于 它 具 有 更 加 灵活 和 透明 的 消 
息 模 型 。 使 用 JMS 的 话 ， 只 有 两 种 消息 模型 可 供 选 择 : 点 对 点 和 发 布 - 订 
阅 。 这 两 种 模型 在 AMQP 当 然 都 是 可 以 实现 的 ， 但 AMQP 还 能 够 让 我 们 
以 其 他 的 多 种 方式 来 发 送 消息 ， 这 是 通过 将 消息 的 生产 者 与 存放 消息 的 
队列 解 簿 实现 的 。 


Spring AMQP 是 Spring 框架 的 扩展 ， 它 能 够 让 我 们 在 Spring 应 用 中 使 用 
AMQP 风 格 的 消息 。 稍 后 可 以 看 到 ，Spring AMQP 提 供 了 一 个 API， 借 
助 这 个 API， 我 们 能 够 以 非常 类 似 于 Spring JMS 抽 象 的 形式 来 使 用 
AMQP。 这 意味 着 ， 我 们 在 本 章 之 前 所 学 习 的 JMS 内 容 能 够 帮助 你 理解 
如 何 使 用 Spring AMQP 来 发 送 和 接收 消息 。 


我 们 稍 后 就 会 介绍 如 何 使 用 Spring AMQP， 但 是 在 深入 学 习 如 何在 
加 发 送 和 接收 消息 之 前 ， 首 先 看 一 下 到 底 是 什么 让 AMQP 如 此 引 
人 关注 。 








17.3.1 AMQP 简 介 


简单 回忆 一 下 JMS 的 消息 模型 ， 可 能 会 有 助 于 理解 AMQP 的 消息 模型 。 

在 JMS 中 ， 有 三 个 主要 的 参与 者 : 消息 的 生产 者 、 消 息 的 消费 者 以 及 在 
生产 者 和 消费 者 之 间 传 递 消息 的 通道 〈 队 列 或 主题 )》 。JMS 消 息 模 型 中 
的 关键 元 素 在 图 17.3 和 图 17.4 中 进行 了 描述 。 


在 JMS 中 ， 通 道 有 助 于 解 耘 消息 的 生产 者 和 消费 者 ， 但 是 这 两 者 依然 会 
与 通道 相 灰 合 。 生 产 者 会 将 消息 发 布 到 一 个 特定 的 队列 或 主题 上 ， 消 费 
者 从 特定 的 队列 或 主题 上 接收 这 些 消 轧 。 通 道具 有 双重 贡 任 ， 也 就 是 传 
递 数 据 以 及 确定 这 些 消 妃 该 发 送 到 什么 地 方 ， 队 列 的 话 会 使 用 点 对 点 算 
法 发 送 ， 主 题 的 话 就 使 用 发 布 -订阅 的 方式 。 


与 之 不 同 的 是 ，AMQP 的 生产 者 并 不 会 直接 将 消息 发 布 到 队列 中 。 
AMQP 在 消息 的 生产 者 以 及 传递 信息 的 队列 之 间 引 入 了 一 种 间接 的 机 
制 : Exchange。 这 种 关系 如 图 17.8 所 示 。 


队列 


图 17.8 ”在 AMQP 中 ， 通 过 引入 处 理 信 息 路 由 的 Exchange， 
消息 的 生产 者 与 消息 队列 之 间 实 现 了 解 夺 






































可 以 看 到 ， 消 息 的 生产 者 将 信息 发 布 到 一 个 Exchange。Exchange 会 绑 定 
到 一 个 或 多 个 队列 上 ， 它 负 贡 将 信息 路 由 到 队列 上 。 信 息 的 消费 者 会 从 
队列 中 提取 数据 并 进行 处 理 。 


图 17.8 所 没有 展现 出 来 的 一 点 是 Exchange 不 是 简单 地 将 消息 传递 到 队列 
中 ， 并 不 仅仅 是 一 种 穿 透 (pass-through) 机制 。AMQP 定 义 了 四 种 不 同 
类 型 的 Exchange， 每 一 种 都 有 不 同 的 路 由 算法 ， 这 些 算法 决定 了 是 否 要 
将 信息 放 到 队列 中 。 根 据 Exchange 的 算法 不 同 ， 它 可 能 会 使 用 消息 的 
routing key 和 /或 参数 ， 并 将 其 与 Exchange 和 队列 之 间 binding 的 routing 
key 和 参数 进行 对 比 。 (routing key 可 以 大 致 理解 为 Email 的 收 件 人 地 

址 ， 指 定 了 预期 的 接收 者 。) 如 果 对 比 结果 满足 相应 的 算法 ， 那 么 消息 
将 会 路 由 到 队列 上 。 人 否则 的 话 ， 将 不 会 路 由 到 队列 上 。 


四 种 标准 的 AMQP Exchange 如 下 所 示 : 


Direct: 如 果 消 息 的 routing key 与 binding 的 routing key 直 接 匹 配 的 
话 ， 消 息 将 会 路 由 到 该 队列 上 ; 

Topic: 如 果 消 息 的 routing key 与 binding 的 routing key 符 合 通配符 匹 
配 的 话 ， 消 息 将 会 路 由 到 该 队列 上 : 

Headers: 如 果 消 息 参 数 表 中 的 头 信息 和 值 都 与 bingding 参 数 表 中 相 
匹配 ， 消 息 将 会 路 由 到 该 队列 上 ; 

Fanout: 不 管 消息 的 routing key 和 参数 表 的 头 信息 / 值 是 什么 ， 消 息 








将 会 路 由 到 所 有 队列 上 。 


借助 这 四 种 类 型 的 Exchange， 很 容易 就 能 想到 我 们 可 以 定义 任意 数量 的 
路 由 模式 ， 而 不 再 仅 限 于 点 对 点 和 发 布 -订阅 的 方式 。D 好 消息 是 ， 当 
发 送 和 接收 消息 的 时 候 ， 所 涉及 的 路 由 算法 对 于 如 何 编写 消息 的 生产 者 
和 消费 者 并 没有 什么 影响 。 人 简单 来 讲 ， 生 产 者 将 信息 发 送 给 Exchange 并 
带 有 一 个 routing key， 消 费 者 从 队列 中 获取 消息 。 


我 们 已 经 快速 了 解 了 AMQP 消 息 的 基本 知识 此 时 应 该 已 经 能 够 理解 
我 们 接 下 来 所 要 介绍 的 如 何 使 用 Spring 发 送 和 接收 消息 。 但 是 ， 我 建议 
你 更 深入 的 学 习 一 下 AMQP， 可 以 阅读 规范 和 www.amqp.org 站 点 上 的 其 
他 资料 ， 或 者 可 以 阅读 Alvaro Videla 和 Jason J.W. Williams 所 编写 的 
《RabbitMQ in Action》 (Manning, 2012, www.manning.com/videla/) 。 


现在 ， 我 们 结束 对 AMQP 的 抽象 讨论 ， 开 始 着 手 编写 借助 Spring AMQP 


发 送 和 接收 消 妃 的 代码 。 首 先 我 们 将 看 到 的 是 一 些 通用 的 配置 ， 它 们 同 
时 适用 于 生产 者 和 消费 者 。 











17.3.2 ”配置 Spring 支持 AMQP 消 息 


当 我 们 第 一 次 使 用 Spring JMS 抽 象 的 时 候 ， 首 先 配 置 了 一 个 连接 工厂 。 
与 之 类 似 ， 使 用 Spring AMQP 前 也 要 配置 一 个 连接 工厂 。 只 不 过 ， 所 要 
配置 的 不 是 JMS 的 连接 工厂 ， 而 是 需要 配置 AMQP 的 连接 工厂 。 更 具体 
来 讲 ， 需 要 配置 RabbitrMQ 连 接 工 厂 。 











什么 是 RabbitMQ 


RabbitMQ 是 一 个 流行 的 开源 消息 代理 ， 它 实现 了 AMQP。Spring AMQP 
为 RabbitMQ 提 供 了 支持 ， 包 括 RabbitMQ 连 接 工 三、 模板 以 及 Spring 配 
置 命 名 空间 。 


在 使 用 它 发 送 和 接收 消息 之 前 ， 你 需要 预先 安装 RabbitMQ 。 我 们 可 以 
在 www.rabbitmq.com/download.html 上 找到 安装 指南 。 根 据 你 所 运行 的 
OS 不 同 ， 这 会 有 所 差别 ， 所 以 根据 环境 的 不 同 ， 遵 循 相 应 指南 进行 安 
装 的 任务 就 留 给 读者 自己 完成 。 


配置 RabbitMQ 连 接 工厂 最 简单 的 方式 就 是 使 用 Spring AMQP 所 提供 的 
rabbit 配 置 命 名 空间 。 为 了 使 用 这 项 功能 ， 需 要 确保 在 Spring 配 置 文件 


中 已 经 声明 了 该 模式 : 


<?xml version="1.6”encoding="UTF-8" ?> 
<beans :beans xmlns="http://www.springframework.org/schema/rabbit" 
xmlns:beans="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2601/XMLSchema-instance" 
xsi:schemaLocation="http://www.springframework.org/schema/rabbit 
http://www.springframework.org/schema/rabbit/spring-rabbit-1.8.xsd 


http://www.springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans.xsd"> 





</beans:beans> 


尽管 不 是 必须 的 ， 但 我 还 选择 在 这 个 配置 中 将 rabbit 作 为 首选 的 命名 
空间 ， 将 beans 作 为 第 二 位 的 命名 空间 。 这 是 因为 在 这 个 配置 中 ， 我 会 
更 多 的 声明 rabbit 而 不 是 bean， 这 样 的 话 ， 只 会 有 少量 的 bean 元 素 使 
用 “beans:” 前 级 ， 而 rabbit 元 素 就 能 够 避免 使 用 前 级 了 。 


rabbit 命 名 空间 包含 了 多 个 在 Spring 中 配置 RabbitMQ 的 元 素 。 但 此 
时 ， 你 最 感 兴趣 的 可 能 就 是 cconnection-factory>。 按 照 其 最 简单 的 
形式 ， 我 们 可 以 在 配置 RabbitMQ 连 接 工 厂 的 时 候 没 有 任何 属性 : 





<connection-factory/> 





这 的 确 能 够 运行 起 来 ， 但 是 所 导致 的 结果 束 是 连接 工厂 bean 没 有 可 用 的 
bean ID， 这 样 的 话 就 难 将 连接 工厂 装配 到 需要 它 的 bean 中 。 因 此 ， 我 们 
可 能 希望 通过 id 属 性 为 其 设置 一 个 bean ID: 


<connection-factory id="connectionFactory”/> 


默认 情况 下 ， 连 接 工厂 会 假设 RabbitMQ 服 务 器 监听 localhost 的 5672 
端口 ， 并 且 用 户 名 和 密码 均 为 guest。 对 于 开发 来 讲 ， 这 是 合理 的 默认 
值 ， 但 是 对 于 生产 环境 ， 我 们 可 能 希望 修改 这 些 默 认 值 。 如 

下 <connection-factory> 的 设置 重 写 了 默认 的 做 法 : 











<connection-factory id="connectionFactory" 
host="${rabbitmq.host}" 
port="${rabbitmq.port}" 


username="${rabbitmq.username}" 
password="${rabbitmq.password}"” /> 





我 们 使 用 占 位 符 来 指定 值 ， 这 样 配 置 项 可 以 在 Spring 配 置 文件 之 外 进行 
管理 〈 很 可 能 位 于 属性 文件 中 ) 。 


除了 连接 工厂 以 外 ， 我 们 还 要 考虑 使 用 其 他 的 几 个 配置 元 素 。 接 下 来 ， 
看 一 下 如 何 创建 队列 、Exchange 以 及 binding。 


声明 队列 、Exchange 以 及 binding 








在 JMS 中 ， 队 列 和 主题 的 路 由 行为 都 是 通过 规范 建立 的 ，AMQP 与 之 不 
同 ， 它 的 路 由 更 加 丰富 和 灵活 ， 依 赖 于 如 何 定义 队列 和 Exchange 以 及 如 
何 将 它们 绑 定 在 一 起 。 声 明 队 列 、Exchange 和 binding 的 一 种 方式 是 使 用 
RabbitMQ channel 接口 的 各 种 方法 。 但 是 直接 使 用 RabbitMQ 的 
channel 接口 非常 麻烦 。Spring AMQP 能 和 否 帮助 我 们 声明 消息 路 由 组 件 
呢 ? 


地 好 ，rabbit 命 名 空间 包含 了 多 个 元 素 ， 帮 助 我 们 声明 队列 、Exchange 
以 及 将 它们 结合 在 一 起 的 binding。 表 17.3 中 列 出 了 这 些 元 素 。 


表 17.3 ”Spring AMQP 的 rabbit 命 名 空间 包含 了 多 个 元 素 ， 用 来 创建 队列 、Exchange 以 及 将 它 
们 结合 在 一 起 的 binding 
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上 建 一 个 fanout 类 型 的 Exchange 


元 素 





<header-exchange> 创建 一 个 header 类 型 的 Exchange 


<direct-exchange> 创建 一 个 direct 类 型 的 Exchange 

















<bindings><binding/> 元 素 定 义 一 个 或 多 个 元 素 的 集合 。 元 素 创 建 Exchange 和 队 
</bindings> 列 之 间 的 binding 





这 些 配 置 元 素 要 与 <admin> 元 素 一 起 使 用 。<admin> 元 素 会 创建 一 个 
RabbitMQ 管 理 组 件 (administrative component) ， 它 会 自动 创建 〈 如 果 
它们 在 RabbitMQ 代 理 中 尚未 存在 的 话 ) 上 述 这 些 元 素 所 声明 的 队列 、 
Exchange 以 及 binding。 


例如 ， 如 果 你 希望 声明 名 为 spittle.alert.queue 的 队列 ， 只 需要 在 
Spring 配置 中 汐 加 如 下 的 两 个 元 素 即 可 : 





<admin connection-factory="connectionFactory"/> 


<queue id="spittleAlertQueue" name="spittle.alerts" /> 





对 于 简单 的 消息 来 说 ， 我 们 只 需 做 这 些 就 足够 了 。 这 是 因为 默认 会 有 一 
个 没有 名 称 的 direct Exchange， 所 有 的 队列 都 会 绑 定 到 这 个 Exchange 

上 ， 并 且 routing key 与 队列 的 名 称 相 同 。 在 这 个 简单 的 配置 中 ， 我 们 可 
以 将 消息 发 送 到 这 个 没有 名 称 的 Exchange 上 ， 并 将 routing key 设 定 

为 spittle.alert.queue， 这 样 消息 就 会 路 由 到 这 个 队列 中 。 实 际 
上 ， 我 们 重新 创建 了 JMS 的 点 对 点 模型 。 


但 是 ， 更 加 有 意思 的 路 由 需要 我 们 声明 一 个 或 更 多 的 Exchange， 并 将 其 
绑 定 到 队列 上 。 例 如 ， 如 果 要 将 消 奶 路 由 到 多 个 队列 中 ， 而 不 管 routing 
key 是 什么 ， 我 们 可 以 按照 如 下 的 方式 配置 一 个 fanout 以 及 多 个 队列 : 


<admin connection-factory="connectionFactory" / 
> <queue name="spittle.alert.queue.1" > <queue name="spittle.alert.qug 
.2" > <queue name="spittle.alert.queue.3" > <fanout- 
exchange name="spittle.fanout"> <bindings> <binding queue="spittle 


ert.queue.1" /> <binding queue="spittle.alert.queue.2" / 
> <binding queue="spittle.alert.queue.3" /> </bindings> </fanout- 
exchange> 





借助 表 17.3 中 的 元 素 ， 会 有 无 数 种 在 RabbitMQ 配 置 路 由 的 方式 ， 但 是 我 
却 没有 无 尽 的 坑 幅 来 为 读者 描述 它们 ， 所 以 为 了 让 我 们 的 讨论 不 至 于 偶 
器 人 的 路 由 作为 练习 留 给 读者 ， 我 将 会 继续 讨论 如 
何 友 壕 消 恩 。 


17.3.3 ”使 用 RabbitTemplate 发 送 消息 


顾名思义 ，RabbitMQ 连 接 工 三 的 作用 是 创建 到 RabbitMQ 的 连接 。 如 果 
你 希望 通过 RabbitMQ 发 送 消息 ， 那 么 你 可 以 

将 connectionFactorybean 注 入 到 AlertServiceImp1 类 中 ， 并 使 用 它 
来 创建 Connection， 使 用 这 个 Connection 来 创建 Channel， 然 后 使 用 
这 个 Channel 发 布 消息 到 Exchange 上。 


是 的 ， 你 的 确 可 以 这 样 做 。 


但 是 ， 如 果 这 样 做 的 话 ， 你 要 做 许多 的 工作 并 且 会 涉及 到 很 多 样板 式 代 
码 。Spring 所 讨厌 的 一 件 事情 就 是 样板 式 代 码 。 我 们 已 经 看 到 Spring 提 
供 模板 来 消除 样板 式 代 码 的 多 个 例子 一 一 包括 本 章 前 面 所 介绍 的 
JmsTemplate， 它 消除 了 JMS 的 样板 式 代码 。 因 此 ，Spring AMQP 提 供 
RabbitTemp1late 来 消除 RabbitMQ 发 送 和 接收 消息 相关 的 样板 式 代码 束 
一 点 也 不 让 人 感觉 奇怪 了 。 


配置 RabbitTemplate 的 最 简单 方式 是 使 用 rabbit 命 名 空间 的 
<template> 元 素 ， 如 下 所 示 : 





<template id="rabbitTemplate" 





connection-factory="connectionFactory" /> 


现在 ， 要 发 送 消息 的 话 ， 我 们 只 需要 将 模板 bean 注 入 

到 AlertServiceImp1 中 ， 并 使 用 它 来 发 送 Spitle。 如 下 的 程序 清单 展 
现 了 一 个 新 版 本 的 AlertSserviceImpl1， 它 使 用 RabbitTemplate 代 蔡 
JmsTemplate 来 发 送 Spittle 提 醒 。 


程序 清单 17.7 使 用 RabbitTemplate 来 发 送 Spittle 





package com.habuma.spitter.alerts; 


import org.springframework.amqp.rabbit.core.RabbitTemplate; 
import org.springframework.beans.factory.annotation.Autowired; 


import com.habuma.spitter.domain.Spittle; 
public class AlertServiceImpl implements AlertService { 


private RabbitTemplate rabbit; 


@Autowired 

public AlertServiceImpl(RabbitTemplate rabbit) { 
this.rabbit = rabbit; 

} 


public void sendSpittleAlert(Spittle spittle) { 
rabbit.convertAndSend("spittle.alert.exchange", 
"spittle.alerts", 
spittle); 





可 以 看 到 ， 现 在 sendSpittleAlert() 调 用 RabbitTemplate 的 
convertAndSsend() 方 法 ， 其 中 RabbitTemplate 是 被 注入 进来 的 。 它 
传 入 了 三 个 参数 : Exchange 的 名 称 、routing key 以 及 要 发 送 的 对 象 。 注 
意 ， 这 里 并 没有 指定 消息 该 路 由 到 何 处 、 要 发 送 给 哪个 队列 以 及 期 望 哪 
个 消费 者 来 获取 消 恩 。 


RabbitTemplate 有 多 个 重 载 版 本 的 convertAndSend() 方 法 ， 这 些 方 
法 可 以 简化 它 的 使 用 。 例 如 ， 使 用 某 个 重 载 版 本 的 convertAndSend() 
方法 ， 我 们 可 以 在 调用 convertAndSend() 的 时 候 ， 不 设置 Exchange 的 
名 称 : 


rabbit.convertAndSend("spittle.alerts", spittle); 


如 果 你 愿意 的 话 ， 还 可 以 同时 省 略 Exchange 名 称 和 routing key: 


rabbit.convertAndSend(spittle); 


如 果 在 参数 列表 中 省 略 Exchange 名 称 ， 或 者 同时 省 略 Exchange 名 称 和 
routing key 的 话 ，RabbitTemplate 将 会 使 用 默认 的 Exchange 名 称 和 
routing key。 按 照 我 们 之 前 的 配置 ， 默 认 的 Exchange 名 称 为 空 (或 者 说 
是 默认 没有 名 称 的 那 一 个 Exchange) ， 默 认 的 routing key 也 为 空 。 但 
是 ， 我 们 可 以 在 <template> 元 素 上 借助 exchange 和 routing-key 属 性 
配置 不 同 的 默认 值 : 








<template id="rabbitTemplate" 
connection-factory="connectionFactory" 
exchange="spittle.alert.exchange" 


routing-key="spittle.alerts" /> 


不 管 设置 的 默认 值 是 什么 ， 我 们 都 可 以 在 调用 convertAndSend() 方 法 
的 时 候 ， 以 参数 的 形式 显 式 指定 它们 ， 从 而 履 兰 抒 默 认 值 。 
RabbitTemplate 还 有 其 他 的 方法 来 发 送 消 奶 ， 你 可 能 会 对 此 感 兴趣 。 
例如 ， 我 们 可 以 使 用 较 低 等 级 的 send ( ) 方 法 来 发 

送 org.springframework.amqp.core.Message 对 象 ， 如 下 所 示 : 


Message helloMessage = 


new Message("Hello World!".getBytes(), new MessageProperties()); 
rabbit.send("hello.exchange", "hello.routing", helloMessage); 





与 convertAndSend() 方 法 类 似 ，send() 方 法 也 有 重 载 形式 ， 它 们 不 需 
要 提供 Exchange 名 称 和 /或 routing key。 


使 用 send() 方 法 的 技巧 在 于 构造 要 发 送 的 Message 对 象 。 在 这 个 “Hello 
World” 样 例 中 ， 我 们 通过 给 定 字 符 串 的 字 节 数组 来 构建 Message 实 例 。 
对 于 String 值 来 说 ， 这 足够 了 ， 但 是 如 果 消 息 的 负载 是 复杂 对 象 的 话 ， 
那 它 就 会 复杂 得 多 。 


鉴于 这 种 情况 ， 我 们 有 了 convertAndSend() 方 法 ， 它 会 自动 将 对 象 转 
换 为 Message。 它 需要 一 个 消息 转换 器 的 帮助 来 完成 该 任务 ， 默 认 的 消 
息 转换 器 是 SimpleMessageConverter， 它 适用 于 

String、Serializable 实 例 以 及 字 节 数组 。Spring AMQP 还 提供 了 其 
Dy 的 消息 转换 器 ， 其 中 包括 使 用 JSON 和 XML 数据 的 消息 转换 


现在 ， 我 们 已 经 发 送 了 消息 ， 接 下 来 我 们 转向 回话 的 另外 一 端 ， 看 一 下 
如 何 获取 消息 。 


17.3.4 ”接收 AMQP 消 息 


我 们 可 以 回忆 一 下 ，JMS 提 供 了 两 种 从 队列 中 获取 信息 的 方式 : 使 

用 JmsTemplate 的 同步 方式 以 及 使 用 消息 驱动 POJO 的 异步 方式 。Spring 

AMQP 提 供 了 类 似 的 方式 来 获取 通过 AMQP 发 送 的 消息 。 因 为 我 们 已 经 

ee 所 以 首先 看 一 下 如 何 使 用 它 同步 地 从 队列 中 获 
消 居 。 




















使 用 RabbitTemplate 来 接收 消息 





RabbitTemp1late 提 供 了 多 个 接收 信息 的 方法 。 最 简单 就 是 receive( ) 
方法 ， 它 位 于 消息 的 消费 者 端 ， 对 应 于 RabbitTemplate 的 send() 方 
法 。 借 助 receive() 方 法 ， 我 们 可 以 从 队列 中 获取 一 个 Message 对 象 : 





Message message = rabbit.receive("spittle.alert.queue"); 





或 者 ， 如 采 愿 意 的 话 ， 你 还 可 以 配置 获取 消 恩 的 默认 队列 ， 这 是 通过 在 
配置 模板 的 时 候 ， 设 置 queue 属 性 实现 的 : 


<template id="rabbitTemplate" 
connection-factory="connectionFactory" 


exchange="spittle.alert.exchange" 
routing-key="spittle.alerts" 
queue="spittle.alert.queue" /> 





这 样 的 话 ， 我 们 在 调用 receive() 方 法 的 时 候 ， 不 需要 设置 任何 参数 吕 
能 从 默认 队列 中 获取 消 轧 了 : 


Message message = rabbit.receive() ; 


在 获取 到 Message 对 象 之 后 ， 我 们 可 能 需要 将 它 body 属 性 中 的 字 节 数组 
转换 为 想 要 的 对 象 。 就 像 在 发 送 的 时 候 将 领域 对 象 转换 为 Message 一 

样 ， 将 接收 到 的 Message 转 换 为 领域 对 象 同样 非常 繁琐 。 因 此 ， 我 们 可 
以 考虑 使 用 RabbitTemplate 的 receiveAndConvert() 方 法 作为 蔡 代 方 


案 : 











Spittle spittle = 





(Spittle) rabbit.receiveAndConvert("spittle.alert.queue"); 


0 这 样 它 束 会 使 用 模板 的 默认 队 
列 名 称 : 


Spittle spittle = (Spittle) rabbit.receiveAndConvert(); 


receiveAndConvert() 方 法 会 使 用 与 sendAndConvert() 方 法 相同 的 
消息 转换 器 ， 将 Message 对 象 转换 为 原始 的 类 型 。 


调用 receive() 和 receiveAndConvert() 方 法 都 会 立即 返回 ， 如 果 队 
列 中 没有 等 待 的 消息 时 ， 将 会 得 到 nul1。 这 残 需 要 我 们 来 管理 轮 询 
(polling) 以 及 必要 的 线程 ， 实 现 队 列 的 监控 。 


我 们 并 非 必 须 同步 轮 询 并 等 待 消息 到 达 ，Spring AMQP 还 提供 了 消息 驱 
动 POJO 的 支持 ， 这 不 禁 使 我 们 回忆 起 Spring JMS 中 的 相同 特性 。 让 我 们 
看 一 下 如 何 通 过 消息 驱动 AMQP POJO 的 方式 来 接收 消息 。 


定义 消息 驱动 的 AMQP POJO 
如 果 你 想 在 消息 驱动 POJO 中 异步 地 消费 使 用 spittle 对 象 ， 首 先 要 解 


决 的 问题 就 是 这 个 POJO 本 号 。 如 下 的 SpittleAlertHandler 扮 演 了 这 
大 
和 角色: 








package com.habuma.spittr.alerts 
import com.habuma.spittr.domain.Spittle; 


public class SpittleAlertHandler { 


public void handleSpittleAlert(Spittle spittle) { 
// ... implementation goes here ... 
} 
} 








注意 ， 这 个 类 与 借助 JMS 消 费 spittle 时 所 用 到 spittleAlertHandler 
完全 一 致 。 我 们 之 所 以 能 够 重用 相同 的 POJO 是 因为 这 个 类 丝 坚 没有 依 
赖 于 JMS 或 AMQP， 并 且 不 管 通过 什么 机 制 传递 过 来 Spittle 对 象 ， 它 
都 能 够 进行 处 理 。 


我 们 还 需要 在 Spring 应 用 上 下 文中 将 SpittleAlertHandler 声 明 为 一 个 
bean: 








<bean id="spittleListener" 





class="com.habuma.spittr.alert.SpittleAlertHandler" /> 


同样 ， 在 使 用 基于 JMS 的 MDP 时 ， 我 们 已 经 做 过 相同 的 事情 ， 没 有 什么 
丝 坚 的 差异 。 


最 后 ， 我 们 需要 声明 一 个 监 昕 器 容器 和 监 昕 器 ， 当 消 恩 到 达 的 时 候 ， 能 
够 调用 spittleAlertHandler。 在 基于 JMS 的 MDP 中 ， 我 们 做 过 相同 





的 事情 ， 但 是 基于 AMQP 的 MDP 在 配置 上 有 一 个 细微 的 差别 : 


<listener-container connection-factory="connectionFactory"> 
<listener ref="spittleListener" 


method="handleSpittleAlert" 
queue-names="spittle.alert.queue" /> 
</listener-container> 








你 看 到 有 什么 差别 了 吗 ? 我 也 同意 这 并 不 那么 明显 。<1Listener- 
container> 与 <listener> 都 与 JMS 对 应 的 元 素 非常 类 似 。 但 是 ， 这 些 
元 素来 自 rabbit 命 名 空间 ， 而 不 是 JMS 命 名 空间 。 


我 都 说 过 了 ， 没 那么 明显 。 


哦 ， 还 有 一 个 细微 的 差别 ， 我 们 不 再 通过 destination 属 性 (JMS 中 的 
做 法 ) 来 监听 队列 或 主题 ， 这 里 我 们 通过 queue-names 属 性 来 指定 要 监 
0 但 是 ， 除 此 之 外 ， 基 于 AMQP 的 MDP 与 基于 JMS 的 MDP 都 非 
党 类似。 


你 可 能 也 意识 到 了 ，queue-names 属 性 的 名 称 使 用 了 复数 形式 。 在 这 里 
我 们 只 设 定 了 一 个 要 监听 的 队列 ， 但 是 允许 设置 多 个 队列 的 名 称 ， 用 过 


号 分 割 即 可 。 


另外 一 种 指定 要 监听 队列 的 方法 是 引用 <queue> 元 素 所 声明 的 队列 
bean。 我 们 可 以 通过 queues 属 性 来 进行 设置 : 








<listener-container connection-factory="connectionFactory"> 
<listener ref="spittleListener" 


method="handleSpittleAlert" 
queues="spittleAlertQueue" /> 
</listener-container> 





同样 ， 这 里 可 以 接受 逗 写 分 割 的 queue ID 列表。 当然 ， 这 需要 我 们 在 声 
明 队 列 的 时 候 ， 为 其 指定 ID。 例 如 ， 如 下 是 重新 定义 的 提醒 队列 ， 这 次 
间 定 了 ID: 


<queue id="spittleAlertQueue" name="spittle.alert.queue" /> 





注意 ， 这 里 的 id 属性 用 来 在 Spring 应 用 上 下 文中 设置 队列 的 bean ID， 


而 name 属 性 指定 了 RabbitMQ 代 理 中 队列 的 名 称 。 


17.4 小结 


异步 消息 通信 与 同步 RPC 相 比 有 几 个 优点 。 间 接 通信 带 来 了 应 用 之 间 的 
松散 胡 合 ， 因 此 减轻 了 其 中 任意 一 个 应 用 出 溃 所 带 来 的 影响 。 此 外 ， 因 
为 消息 转发 给 了 收 件 人 ， 因 此 发 送 者 不 必 等 待 响 应 。 在 很 多 情况 下 ， 这 
会 提高 应 用 的 性 能 。 


虽然 JMS 为 所 有 的 Java 应 用 程序 提供 了 异步 通信 的 标准 API， 但 是 它 使 
用 起 来 很 系 珊 。Spring 消 除了 JMS 样 板式 代码 和 异常 捕获 代码 ， 让 了 开 步 
消息 通信 更 易于 使 用 。 


在 本 半 中 ， 我们 了 解 了 Spring 通 过 消 虫 代理 和 JMS 建 并 应 用 程序 之 间 寞 
步 通信 的 几 种 方式 。Spring 的 JMS 模 板 消除 了 传统 的 JMS 编 程 模型 所 必 
需 的 样板 式 代 码 ， 而 基于 Spring 的 消 轧 驱动 bean 可 以 通过 声明 bean 的 方 
法 允许 方法 啊 应 来 自 于 队列 或 主题 中 的 消 上 月 。 我 们 同样 了 解 了 如 何 通过 
Spring 的 JMS invoker 为 Spring bean 提 供 基 于 消息 的 RPC。 


在 本 章 中 ， 我 们 已 经 看 到 了 如 何在 应 用 程序 之 间 使 用 异步 通信 。 在 下 一 
半 中 ， 我 们 将 会 延续 这 一 话题 ， 了 解 如 何 借助 WebSocket 在 其 于 浏览 占 
的 客户 端 和 服务 器 之 间 实 现 异 步 通信 。 

















[1] 作 者 幽默 夸张 的 说 法 。 一 一 译 者 注 


[2] 如 果 读 到 此 处 ， 你 觉得 AMQP 能 够 不 局 限于 Java 语 言 和 平台 ， 那 说 明 
你 已 经 快速 抓 到 了 重点 。 


[3] 有 一 点 我 还 没有 提 到 ， 那 束 是 可 以 将 某 个 Exchange 绑 定 到 另外 一 个 
Exchange 上 ， 创 建 路 由 的 内 肉 等 级 结构 。 


第 18 章 ”使 用 WebSsocket 和 STOMP 
实现 消 姑 功能 
本 章 内 容 ; 


。 在 浏览 右 和 服务 器 之 间 发 送 消 妃 
。 在 Spring MVC 控 制 器 中 处 理 消息 
。 为 目标 用 户 发 送 消 息 


在 上 一 章 中 ， 我 们 看 到 了 如 何 使 用 JMS 和 AMQP 在 应 用 程序 之 间 发 送 消 
息 。 异 步 消 息 是 应 用 程序 之 间 通 用 的 交流 方式 。 但 是 ， 如 果菜 一 应 用 是 
运行 在 Web 浏 览 器 中 ， 那 我 们 就 需要 一 些 稍微 不 同 的 技巧 了 。 


WebSocket 协 议 提供 了 通过 一 个 套 接 字 实 现 全 双 工 通信 的 功能 。 除 了 其 
他 的 功能 之 外 ， 它 能 够 实现 Web 浏 览 器 和 服务 器 之 间 的 异步 通信 。 全 双 
工 意 味 独 服务 器 可 以 发 送 消 息 给 浏览 喜 ， 浏 览 圳 也 可 以 发 送 消 妃 给 服务 
峰 。 


Spring 4.0 为 WebSocket 通 信 提 供 了 文 持 ， 包 括 : 


。 发 送 和 接收 消息 的 低层 级 API; 

。 发 送 和 接收 消息 的 高 级 API; 

。 用 来 发 送 消息 的 模板 ; 

。 支持 SockJS， 用 来 解决 浏览 器 端 、 服 务 器 以 及 代理 不 支持 
WebSocket 的 问题 。 


在 本 章 中 ， 我 们 将 会 学 习 借 助 Spring 的 WebSocket 功 能 实现 服务 右 端 和 
基于 浏览 器 的 应 用 之 间 实 现 异步 通信 。 我 们 首先 会 从 如 何 使 用 Spring 的 
低层 级 WebSocket API 开 始 。 











18.1 使 用 Spring 的 低层 级 WebSocket API 


按照 其 最 简单 的 形式 ，WebSocket 只 是 两 个 应 用 之 间 通 信 的 通道 。 位 于 
WebSocket 一 端的 应 用 发 送 消息 ， 另 外 一 端 处 理 消息 。 因 为 它 是 全 双 工 
的 ， 所 以 每 一 端 都 可 以 发 送 和 处 理 消 息 。 如 图 18.1 所 示 。 























图 18.1 WebSocket 是 两 个 应 用 之 间 全 双 工 的 通信 通道 


WebSocket 通 信 可 以 应 用 于 任何 类 型 的 应 用 中 ， 但 是 WebSocket 最 常见 

的 应 用 场景 是 实现 服务 器 和 基于 浏览 器 的 应 用 之 间 的 通信 。 浏 览 器 中 的 

JavaScript 客 户 端 开 局 一 个 到 服务 器 的 连接 ， 服 务 喜 通过 这 个 连接 发 送 更 

| J 相 比 历史 上 轮 询 服 务 端 以 查找 更 新 的 方案 ， 这 种 技术 更 加 
效 和 自然 。 


为 了 阐述 Spring 低层 级 的 WebSocket API, 让 我 们 编写 一 个 简单 的 
WebSocket 样 例 ， 基于 JavaScript 的 客户 端 与 服务 器 玩 一 个 无 休止 
Polo” 游 戏 。 服 务 器 端的 应 用 会 处 理 文本 消息 (“Marco!”) ， 

然后 在 相同 的 连接 上 往 回 发 送 文 本 消息 〈“Polol”) 。 为 了 在 Spring 使 用 
较 低层 级 的 API 来 处 理 消息 ， 我 们 必须 编写 一 人 1 实现 
WebSocketHandler 的 类 : 

















public interface WebSocketHandler { 
void afterConnectionEstablished(WebSocketSession session) 
throws Exception; 
void handleMessage(WebSocketSession session, 
WebSocketMessage<?> message) throws Exception; 


void handleTransportError(WebSocketSession session, 

Throwable exception) throws Exception; 
void afterConnectionClosed(WebSocketSession session, 

CloseStatus closeStatus) throws Exception; 
boolean supportsPartialMessages() ; 





可 以 看 到 ，WebsocketHandler 需 要 我 们 实现 五 个 方法 。 相 比 直 接 实现 
WebSocketHandler， 更 为 简单 的 方法 是 扩 

展 AbstractWebSocketHandler， 这 是 WebSocketHandler 的 一 个 抽象 
实现 。 如 下 的 程序 清单 展现 了 MarcoHandler， 它 

是 AbstractWebSocketHandler 的 一 个 子 类 ， 会 在 服务 器 端 处 理 消 恩 。 


程序 清单 18.1 MarcoHandler 处 理 通 过 WebSocket 传 送 的 文本 消息 


package marcopolo; 


import org.slf4j.Logger:; 
import org.slf4j .Logg 
import org.springfram 
import org.springframewr 


import org.es ingf ‘ework .web . socket .handler.AbstractWebSocketHandler; 












publ le 
private static final Logger logger = 
LoggerFactory .getLogger (MarcoHandler.class); 处 理 
hm 
和 , 文本 消息 
protected void handleTextMessage! 
ion session, TextMessage message) throws Exception { 
eceived message: " + message.getPayload!()):; 
Pp 
模拟 延 时 
session.sendMessage (new TextMessage("Polo!")); < 发 送 文 本 消息 
} 


尽管 AbstractWebSsocketHandler 是 一 个 抽象 类 ， 但 是 它 并 不 要 求 我 们 
必须 重 载 任 何 特定 的 方法 。 相 反 ， 它 让 我 们 来 决定 该 重 载 哪 一 个 方法 。 

除了 重 载 NebSocketHandler 中 所 定义 的 五 个 方法 以 外 ， 我 们 还 可 以 重 
载 AbstractWebSocketHandler 中 所 定义 的 三 个 方法 : 


e handleBinaryMessage() 
e handlePpongMessage() 
e handleTextMessage() 





这 三 个 方法 只 是 handleMessage( ) 方 法 的 具体 化 ， 每 个 方法 对 应 于 某 
一 种 特定 类 型 的 消息 。 


因为 MarcoHandler 将 会 处 理 文本 类 型 的 “Marco!” 消 息 ， 因 此 我 们 应 该 
重 载 handleTextMessage( ) 方 法 。 当 有 文本 消息 抵达 的 时 候 ， 日 志 会 
记录 消息 内 容 ， 在 两 秒 钟 的 模拟 延迟 之 后 ， 在 同一 个 连接 上 返回 另外 一 
条 文本 消息 。 


MarcoHandler 所 没有 重 载 的 方法 都 由 AbstractWwebSocketHandler 以 
空 操作 的 方式 (no-op〉 进行 了 实现 。 这 意味 痢 MarcoHandler 也 能 处 理 
二 进 制 和 pong 消 息 ， 只 是 对 这 些 消息 不 进行 任何 操作 而 已 。 


另外 一 种 方案 ， 我 们 可 以 扩展 TextWebSsocketHandler， 不 再 扩 
展 Abstract-WebSocketHandler: 


public class MarcoHandler extends TextWebSocketHandler { 
} 


TextWebSsocketHandler 是 AbstractWebSocketHandler 的 子 类 ， 它 会 
拒绝 处 理 二 进 制 消 息 。 它 重 载 了 handleBinaryMessage() 方 法 ， 如 果 

收 到 二 进 制 消息 的 时 候 ， 将 会 关闭 WebSocket 连 接 。 与 之 类 

似 ，BinaryWebsocketHand1ler 也 是 AbstractWNeb-SocketHandler 的 
子 类 ， 它 重 载 了 handleTextMessage() 方 法 ， 如 果 接 收 到 文本 消息 的 

话 ， 将 会 关闭 连接 。 


尽管 你 会 关心 如 何 处 理 文 本 消息 或 二 进 制 消 恕 ， 或 者 二 者 羔 而 有 之 ， 但 
是 你 可 能 还 会 对 建立 和 关闭 连接 感 兴趣 。 在 本 例 中 ， 我 们 可 以 重 
载 afterConnectionEstab1lished() 和 afterConnectionClosed(): 











public void afterConnectionEstablished(WebSocketSession session) 
throws Exception { 
logger.info("Connection established"); 


} 


@Override 
public void afterConnectionClosed( 
WebSocketSession session, CloseStatus status) throws Exception { 
logger.info("Connection closed. Status: " + status); 


} 





我 们 通过 afterConnectionEstablished() 和 和 
afterConnectionClosed() 方 法 记录 了 连接 信息 。 当 新 连接 建立 的 时 
候 ， 会 调用 afterConnectionEstab1lished() 方 法 ， 类 似 地 ， 当 连接 
关闭 时 ， 会 调用 afterConnectionClosed() 方 法 。 在 本 例 中 ， 连 接 事 
件 仅 仅 记 录 了 日 志 ， 但 是 如 果 我 们 想 在 连接 的 生命 周期 上 建立 或 销毁 资 
源 时 ， 这 些 方法 会 很 有 用 。 








注意 ， 这 些 方 法 都 是 以 “after* 开 头 。 这 意味 着 ， 这 些 事件 只 能 在 事件 发 
生 后 才 产 生 啊 应 ， 因 此 并 不 能 改变 结果 。 

现在 ， 已 经 有 了 消息 处 理 器 类 ， 我 们 必须 要 对 其 进行 配置 ， 这 样 Spring 
才能 将 消息 转发 给 它 。 在 Spring 的 Java 配 置 中 ， 这 需要 在 一 个 配置 类 上 
使 用 @EnablewWebsocket， 并 实现 WebsocketConfigurer 接 口 ， 如 下 
面 的 程序 清单 所 示 。 


程序 清单 18.2 在 Java 配 置 中 ， 启 用 WebSocket 并 映射 消 晨 处理 器 


package marcopolo; 





import org.springframework.context .annotation.Bean; 


import org.springframework .web.socket.config.annotation. 


Ena 









import org.springframework.web.socket.config. 
import org.springframework .web.socket.co 
@EnableWebSsSocket 
public class WebSocketConfig implements WebSo 
QOverride 
public void registerWebSocketHandlers!( 
WebSocketHandlerRegistry registry) { 


registry.addHandler (marcoHandler{(), "/marco"); , 
N 将 MarcoHandler 
: "| 
映射 到 “/marco” 
&Bean 


public MarcoHandler marcoHandler() { 


声明 


return new MarcoHandler(); 
MarcoHandler bean 


} 

registerWebsocketHandlers() 方 法 是 注册 消息 处 理 器 的 关键 。 通 过 
重 载 该 方法 ， 我 们 得 到 了 一 个 NebsocketHandlerRegistry 对 象 ， 通 过 
该 对 象 可 以 调用 addHandler() 来 注册 信息 处 理 器 。 在 本 例 中 ， 我 们 注 


册 了 MarcoHandler〈 以 bean 的 方式 进行 声明 ) 并 将 其 与 “rmarco” 路 径 相 
关联 。 


另外 ， 如 果 你 更 喜欢 使 用 XML 来 配置 Spring 的 话 ， 那 么 可 以 使 
用 websocket 命 名 空间 : 


程序 清单 18.3 ”借助 websocket 命 名 空间 以 XML 的 方式 配置 WebSocket 


<?xml] version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.o0org/2001/XMLSchema-instance" 
xmlns:websocket="http://www.springframework.org/schema/websocket" 
xsi:schemaLocation=" 
http://www.springframework.org/schema/websocket 
http://www.springframework.org/schema/websocket/spring-websocket .xsd 
http://www. springframework.org/schema/beans 
http://www.springframework.org/schema/beans/spring-beans .xsd"> 


<websocket :handlers> 
<websocket :mapping handler="marcoHandler" path="/marco" 


</websocket :handlers> 将 Marco 
Handle 映射 
<bean id="marcoHandler" 到 “/marco” 
class="marcopolo.MarcoHandler" /> pe 
声明 
</beans> MarcoHandler bean 


不 管 使 用 Java 还 是 使 用 XML， 这 就 是 所 需 的 配置 。 

现在 ， 我 们 可 以 把 注意 力 转 回 客 户 端 ， 它 会 发 送 “Marcol” 文 本 消息 到 服 
务 器 ， 并 监听 来 自 服务 器 的 文本 消息 。 如 下 程序 清单 所 展示 的 JavaScript 
代码 开启 了 一 个 原始 的 WebSocket 并 使 用 它 来 发 送 消息 给 服务 器 。 


程序 清单 18.4 连接 到 “marco”WebSocket 的 JavaScript 客 户 端 


var Url = 'ws://' + window.location.host + ‘'/websocket/marco'; 
Var sock = new WebSocket (url); 4 打开 WebSocket 
sock.onopen = function() { 要 处 理 连 接 开 启事 件 


console.logl'Opening'); 


sayMarcol(); 


于 

Sock .onmessage = functionle) { < 处 理 信息 
console.logl(l'Received message: ', e.data); 
setTimeout (function() {sayMarco()}, 2000):; 

于 

sock.onclose = function() { 七 处 理 连 接 关 闭 事件 
console.log('Closing'); 

Vs» 

| 


function sayMarco() { 
console.log('Sending Marco!'); 
sm ml ey ("Ms Nn) VE ke 
sock.send ("Marco!"); + 发 送 消 息 
} 





在 程序 清单 18.4 的 代码 中 ， 所 做 的 第 一 件 事 情 束 是 创建 WebSocket 实 
例 。 对 于 支持 WebSocket 的 浏览 右 来 说 ， 这 个 类 型 是 原生 的 。 通 过 创建 
WebSocket 实 例 ， 实 际 上 打开 了 到 给 定 URL 的 WebSocket。 在 本 例 中 ， 
URL 使 用 了 “ws:/* 前 经， 表明 这 是 一 个 基本 的 WebSocket 连 接 。 如 果 是 
安全 WebSocket 的 话 ， 协 议 的 前 级 将 会 是 “wss://”。 





WebSsocket 创 建 完 毕 之 后 ， 接 下 来 的 代码 建立 了 Websocket 的 事件 处 理 
功能 。 注 意 ，WebSocket 的 onopen、onmessage 和 onclose 事 件 对 应 于 
MarcoHandler 的 after- 
ConnectionEstablished()、handleTextMessage() 和 和 
afterConnectionClosed() 方 法 。 在 onopen 事 件 中 ， 设 置 了 一 个 函 
数 ， 它 会 调用 sayMarco(1) 方 法 ， 在 该 WebSocket 上 发 送 *Marcol” 消 息 。 
通过 发 送 “Marco!”， 这 个 无 休止 的 Marco Polo 游 戏 就 开始 了 ， 因 为 服务 
器 端的 MarcoHandler 作 为 啊 应 会 将 *Polo!” 发 送 回来 ， 当 客户 端 收 到 来 
自 服 务 器 的 消息 后 ，onmessage 事 件 会 发 送 另 外 一 个 “Marcol” 给 服务 
可 


这 个 过 程 会 一 直 持 续 下 去 ， 直 到 连接 关闭 。 在 程序 清单 18.4 中 所 没有 展 
示 的 是 如 果 调 用 sock.close() 的 话 ， 将 会 结束 这 个 疯狂 的 游戏 。 在 服 
务 问 也 可 以 关闭 连接 ， 或 者 浏览 器 转 回 其 他 的 页 面 ， 都 会 关闭 连接 。 如 
果 发 生 以 上 任意 的 场景 ， 只 要 连接 关闭 ， 都 会 触发 onclose 事 件 。 在 这 
里 ， 出 现 这 种 情况 将 会 在 控制 台 日 志 上 记录 一 条 信息 。 


到 此 为 止 ， 我 们 已 经 编写 完 使 用 Spring 低层 级 WebSocket API 的 所 有 代 
码 ， 包 括 接收 和 发 送 消息 的 处 理 器 类 ， 以 及 在 浏览 髓 端 完成 相同 功能 的 
JavaScript 客 户 端 。 如 果 我 们 构建 这 些 代码 并 将 其 部 署 到 Servlet 容 峰 中 ， 
那 它 有 可 能 能 够 正常 运行 。 

从 我 选择 “可 能 ”这 个 词 ， 你 是 不 是 能 够 感觉 到 这 里 有 一 点 悲观 的 情绪 ? 
这 是 因为 我 不 能 保证 它 可 以 正常 运行 。 实 际 上 ， 它 很 有 可 能 运行 不 起 
来 。 即 便 把 所 有 的 事情 都 做 对 了 ， 诡 异 的 事情 依然 会 困扰 我 们 。 

证 我 们 看 一 下 都 有 什么 事情 会 阻止 WebSocket 正 常 运行 ， 并 采取 一 些 措 
施 提 高 成 功 的 几率 。 



































18.2 ”应 对 不 文 持 WebSocket 的 场景 


WebSocket 是 一 个 相对 比较 新 的 规范 。 虽 然 它 早 在 2011 年 底 束 实现 了 规 
范 化 ， 但 即便 如 此 ， 在 web 浏览 器 和 应 用 服务 器 上 依然 没有 得 到 一 致 的 
支持 。Firefox 和 Chrome 早 就 已 经 完整 支持 WebSocket 了， 但 是 其 他 的 一 
些 浏览 器 刚刚 开始 支持 WebSocket。 如 下 列 出 了 几 个 流行 的 浏览 器 支持 
WebSocket 功 能 的 最 低 版 本 : 


Internet Explorer: 10.0 

Firefox: 4.0〈 部 分 支持 ) ，6.0( 完 整 支持 ) 。 
Chrome: 4.0 (部 分 支持 ) ，13.0 (完整 支持 ) 。 
Safari: 5.0 (部 分 支持 ) ，6.0 (完整 支持 ) 。 
Opera: 11.0 (部 分 支持 ) ，12.10 (完整 支持 )。 
iOS Safari: 4.2《〈 部 分 文 持 ) ，6.0《〈 完 整 文 持 ) 。 
Android Browser: 4.4。 


令 人 遗憾 的 是 ， 很 多 的 网 上 冲浪 者 并 没有 认识 到 或 理解 新 Web 浏 览 器 的 
特性 ， 因 此 升级 很 慢 。 男 外 ， 有 的 公司 规定 使 用 特定 版 本 的 浏览 器 ， 这 
样 它 们 的 员工 很 难 《 或 不 可 能 ) 使 用 更 新 的 浏览 希 。 鉴 于 这 些 情况 ， 如 
果 你 的 应 用 程序 使 用 WebSocket 的 话 ， 用 户 可 能 会 无 法 使 用 。 


服务 器 端 对 WebSocket 的 支持 也 好 不 到 哪里 去 。GlassFish 在 几 年 前 束 开 
始 支 持 一 定形 式 的 WebSocket， 但 是 很 多 其 他 的 应 用 服务 器 在 最 近 的 版 
本 中 刚刚 开始 支持 WebSocket。 例 如 ， 我 在 测试 上 述 例子 的 时 候 ， 所 使 
用 的 就 是 Tomcat 8 的 发 布 候选 构建 版 本 。 


即便 浏览 器 和 应 用 服务 器 的 版 本 都 符合 要 求 ， 两 端 都 支持 WebSocket， 
在 这 两 者 之 间 还 有 可 能 出 现 问 题 。 防 火 墙 代 理 通 常会 限制 所 有 除 HTTP 
以 外 的 流量 。 它 们 有 可 能 不 支持 或 者 (还 ) 没有 配置 允许 进行 
WebSocket 通 信 。 


在 当前 的 WebSocket 领 域 ， 我 也 许 描 述 了 一 个 很 明暗 的 前 景 。 但 是 ， 不 
要 因为 这 一 些 不 支持 ， 你 就 停止 使 用 WebSocket 的 功能 。 当 它 能 够 正常 
使 用 的 时 候 ，WebSocket 是 一 项 非常 棒 的 技术 ， 但 是 如 果 它 无 法 得 到 文 
持 的 话 ， 我 们 所 需要 的 仅仅 是 一 种 备用 方案 (fallback plan) 。 














泣 好 ， 提 到 WebSocket 的 备用 方案 ， 这 恰 是 SockJS 所 擅长 的 。SockJS 是 
WebSocket 拉 术 的 一 种 模拟 ， 在 表面 上 ， 它 尽 可 能 对 应 WebSocket APL， 
但 是 在 底层 它 非常 智能 ， 如 果 WebSocket 技 术 不 可 用 的 话 ， 就 会 选择 另 
外 的 通信 方式 。SockJS 会 优先 选用 WebSocket， 但 是 如 果 WebSocket 不 可 
用 的 话 ， 它 将 会 从 如 下 的 方案 中 挑选 最 优 的 可 行 方案 : 


XHR 流 。 

XDR 流 。 
iFrame 事 件 源 。 
iFrame HTML 文 件 。 
XHR 轮 询 。 

XDR 轮 询 。 

iFrame XHR 轮 询 。 
JSONP 轮 询 。 


好 消息 是 在 使 用 SockJS 之 前 ， 我 们 并 没有 必要 全 部 了 解 这 些 方 案 。 
SockJS 让 我 们 能 够 使 用 统一 的 编程 模型 ， 束 好 像 在 各 个 层面 都 完整 支持 
WebSocket 一 样 ，SockJS 在 底层 会 提供 备用 方案 。 


例如 ， 为 了 在 服务 端 启用 SockJS 通 信 ， 我 们 在 Spring 配 置 中 可 以 很 简单 
地 要 求 添加 该 功能 。 重 新 回顾 一 下 程序 清单 18.2 中 的 
registerWebSocketHandlers() 方 法 ， 稍 微 加 一 点 内 容 就 能 启用 
SockJS: 

















@Override 
public void registerWebSocketHandlers( 


WebSocketHandlerRegistry registry) { 
registry.addHandler(marcoHandler(), "/marco").withSockJS(); 





addHandler() 方 法 会 返回 WebSocketHandlerRegistration， 通 过 简 
单 地 调用 其 withsockJs() 方 法 就 能 声明 我 们 想 要 使 用 SockJS 功 能 ， 如 
果 WebSocket 不 可 用 的 话 ，SockJS 的 备用 方案 就 会 发 挥 作 用 。 


如 果 你 使 用 XML 来 配置 Spring 的 话 ， 局 用 SockJS 只 需 在 配置 中 添 
加 <websocket:sockjs> 元 素 即 可 : 





<websocket:handlers> 
<websocket:mapping handler="marcoHandler" path="/marco" /> 


<websocket:sockjs /> 
</websocket:handlers> 
要 在 客户 端 使 用 SockJS， 需 要 确保 加 载 了 SockJS 客 户 端 库 。 具 体 的 做 法 
在 很 大 程度 上 依赖 于 使 用 JavaScript 模 块 加载 器 〈 如 require js 或 cul js) 
还 是 简单 地 使 用 <cscript> 标 签 加 载 JavaScript 库 。 加 载 SockJS 客 户 端 库 


的 最 简单 办 法 是 使 用 <script> 标 签 从 SockJS CDN 中 进行 加 载 ， 如 下 所 
修 \: 





<script src="http://cdn.sockjs.org/sockjs-60.3.min.js"></script> 





用 WebjJars 解 析 Web 资 源 


在 我 的 样 例 代 码 中 ， 使 用 了 WebJars 来 解析 JavaScript 库 ， 使 其 作为 
项 目 Maven 或 Gradle 构 建 的 一 部 分 ， 就 像 其 他 的 依赖 一 样 。 为 了 文 
持 该 功能 ， 我 在 Spring MVC 配 置 中 搭建 了 一 个 资源 处 理 器 ， 让 它 负 
责 解析 路 径 以 “/webjars/**” 开 头 的 请 求 ， 这 也 是 WebJars 的 标准 路 


pe 
人 径 : 


@Override 
public void addResourceHandlers(ResourceHandlerRegistry registry) { 


registry.addResourceHandler("/webjars/**") 
.addResourceLocations("classpath:/META-INF/resources/webjars/"); 





在 这 个 资源 处 理 器 准备 就 绪 后 ， 我 们 可 以 在 Web 页 面 中 使 用 如 下 的 
<script> 标 签 加 载 SockJS 库 : 


<script th:src="@{/webjars/sockjs-client/8.3.4/sockjs.min.js}"> 





</script> 


注意 ， 这 个 特殊 的 <script> 标 签 来 源 于 一 个 Thymeleaf 模 板 ， 并 使 
Us .}” 表 达 式 来 为 JavaScript 文 件 计算 完整 的 相对 于 上 下 文 的 
UREL 路 径 。 


除了 加 载 SockJS 客 户 端 库 以 外 ， 在 程序 清单 18.4 中 ， 要 使 用 SockJS 只 需 
修改 两 行 代码 : 


var url = 'marco'; 


var sock = new SockJS(ur]l); 


所 做 的 第 一 个 修改 就 是 URL。SockJS 所 处 理 的 URL 

是 “http://” 或 “https:// 模 式 ， 而 不 是 “ws:/” 和 “wss:/”。 即 便 如 此 ， 我 们 还 
是 可 以 使 用 相对 URL， 避 免 书写 完整 的 全 限定 URL。 在 本 例 中 ， 如 果 包 
含 JavaScript 的 页 面 位 于 “http://localhost:8080/websocket” 路 径 下 ， 那 么 给 
定 的 “marco” 路 径 将 会 形成 到 “http://localhost:8080/websocket/marco” 的 连 
接 。 


但 是 ， 这 里 最 核心 的 变化 是 创建 SockJS 实 例 来 代替 MebSocket。 

为 SockJS 尽 可 能 地 模拟 了 Websocket， 所 以 程序 清单 18.4 中 的 其 他 代码 
并 不 需要 变化 。 相 同 的 onopen、onmessage 和 onclose 事 件 处 理 函 数 用 
来 啊 应 对 应 的 事件 ， 相 同 的 send() 方 法 用 来 发 送 *Marcol” 到 服务 器 端 。 


我 们 并 没有 改变 很 多 的 代码 ， 但 是 客户 端 -服务 器 之 间 通 信 的 运行 方式 
却 有 了 很 大 的 变化 。 我 们 可 以 完全 相信 客户 端 和 服务 器 之 间 能 够 进行 类 
似 于 WebSocket 这 样 的 通信 ， 即 便 浏览 器 、 服 务 器 或 位 于 中 间 的 代理 不 
支持 WebSocket， 我 们 也 无 需 再 担心 了 。 


WebSocket 提 供 了 浏览 器 -服务 器 之 间 的 通信 方式 ， 当 运行 环境 不 文 持 
WebSocket 的 时 候 ，SockJS 提 供 了 备用 方案 。 但 是 不 管 哪 种 场景 ， 对 于 
实际 应 用 来 说 ， 这 种 通信 形式 都 显得 层级 过 低 。 让 我 们 看 一 下 如 何在 
WebSocket 之 上 使 用 STOMP (Simple Text Oriented Messaging 

Protocol) ， 为 浏览 器 -服务 器 之 间 的 通信 增加 恰当 的 消息 语义 。 














18.3 ”使 用 STOMP 消 息 


如 果 我 要 求 你 编写 一 个 Web 应 用 程序 ， 在 讨论 需求 之 前 ， 你 可 能 对 于 要 

采用 的 基础 拉 术 和 框架 就 有 了 很 好 的 想法 。 即 便 是 简单 的 “Hello 

World”Web 应 用 ， 你 可 能 也 会 考虑 使 用 Spring MVC 控 制 费 来 处 理 请 求 ， 

并 为 响应 使 用 JSP 或 Thymeleaf 模 板 。 至 少 ， 你 也 应 该 会 创建 一 个 静态 的 

HTML 页 面 ， 并 让 Web 服 务 嚣 处理 来 自 Web 浏 览 器 的 相应 请 求 。 我 们 应 

0 
月 。o 


现在 ， 我 们 假设 HTTP 协 议 并 不 存在 ， 只 能 使 用 TCP 套 接 字 来 编写 Web 

应 用 。 你 可 能 认为 我 已 经 疯 掉 了 。 当 然 ， 我 们 也 许 能 够 完成 这 一 壮举 ， 

但 是 这 需要 自行 设计 客户 端 和 服务 器 端 都 认可 的 协议 ， 从 而 实现 有 效 的 
通信 。 简 单 来 说 ， 这 不 是 一 件 容易 的 事情 。 


不 过 ， 幸 好 我 们 有 HTTP， 它 解决 了 Web 浏 览 器 发 起 请 求 以 及 Web 服 务 
器 啊 应 请 求 的 细节 。 这 样 的 话 ， 大 多 数 的 开发 人 员 并 不 需要 编写 低层 级 
TCP 套 接 字 通信 相关 的 代码 。 


直接 使 用 WebSocket 〈 或 SockJS) 就 很 类 似 于 使 用 TCP 套 接 字 来 编写 
Web 应 用 。 因 为 没有 高 层级 的 线路 协议 (wire protocol) ， 因 此 就 需要 
我 们 定义 应 用 之 间 所 发 送 消息 的 语义 ， 还 需要 确保 连接 的 两 端 都 能 遵循 
这 些 语义 。 


不 过 ， 好 消息 是 我 们 并 非 必 须要 使 用 原生 的 WebSocket 连 接 。 束 像 HTTP 
在 TCP 套 接 字 之 上 添加 了 请 求 - 啊 应 模型 层 一 样 ，STOMP 在 WebSocket 之 
上 提供 了 一 个 基于 帧 的 线路 格式 〈frame-based wire format) 层 ， 用 来 定 
义 消 恩 的 语义 。 


乍 看 上 去 ，STOMP 的 消息 格式 非常 类 似 于 HTTP 请 求 的 结构 。 与 HTTP 
请 求 和 啊 应 类 似 ，STOMP 帧 由 命令 、 一 个 或 多 个 头 信息 以 及 负载 所 组 
成 。 例 如 ， 如 下 就 是 发 送 数据 的 一 个 STOMP 帧 : 

















SEND 
destination:/app/marco 
content-length:206 


{\"message\":\"Marcol!l\"} 


在 这 个 简单 的 样 例 中 ，STOMP 命 令 是 send， 表 明 会 发 送 一 些 内 容 。 紧 
接着 是 两 个 头 信 息 : 一 个 用 来 表示 消息 要 发 送 到 哪里 的 目的 地 ， 另 外 一 
个 则 包含 了 负载 的 大 小 。 然 后 ， 紧 接着 是 一 个 空 行 ，STOMP 帧 的 最 后 
是 负载 内 容 ， 在 本 例 中 ， 是 一 个 JSON 消 息 。 


STOMP 帧 中 最 有 意思 的 恐怕 就 是 destination 头 信息 了 。 它 表明 
STOMP 是 一 个 消息 协议 ， 类 似 于 JMS 或 AMQP。 消 息 会 发 布 到 某 个 目的 
地 ， 这 个 目的 地 实际 上 可 能 真 的 有 消息 代理 〈message broker) 作为 文 
撑 。 男 一 方面 ， 消 息 处 理 器 (message handler) 也 可 以 监听 这 些 目的 
地 ， 接 收 所 发 送 过 来 的 消息 。 


在 WebSocket 通 信 中 ， 基 于 浏览 器 的 JavaScript 必 用 可 能 会 发 送 消息 到 一 

个 目的 地 ， 这 个 目的 地 由 服务 器 端的 组 件 来 进行 处 理 。 其 实 ， 反 过 来 是 
一 样 的 ， 服 务 嚣 端的 组 件 也 可 以 发 布 消 奶 ， 由 JavaScript 客 户 问 的 目的 地 
来 接收 。 


Spring 为 STOMP 消 息 提 供 了 基于 Spring MVC 的 编程 模型 。 稍 后 将 会 看 
到 ， 在 Spring MVC 控 制 器 中 处 理 STOMP 消 息 与 处 理 HTTP 请 求 并 没有 太 
大 的 差别 。 但 首先 ， 我 们 需要 配置 Spring 启 用 基于 STOMP 的 消息 。 











18.3.1 启用 STOMP 消 息 功 能 


稍 后， 我 们 将 会 看 到 如 何在 Spring MVC 中 为 控制 器 方法 添 

加 @MessageMapping 注 解 ， 使 其 处 理 STOMP 消 四 ， 它 与 市 

有 @RequestMapping 注 解 的 方法 处 理 HTTP 请 求 的 方式 非常 类 似 。 但 是 
与 @RequestMapping 不 同 的 是 ，@MessageMapping 的 功能 无 法 通过 
@EnableWebMvc 启 用 。Spring 的 Web 消 息 功 能 基于 消息 代理 (message 
broker) 构建 ， 因 此 除了 告诉 Spring 我 们 想 要 处 理 消息 以 外 ， 还 有 其 他 
me 我 们 必须 要 配置 一 个 消息 代理 和 其 他 的 一 些 消 息 目 的 


如 下 的 程序 清单 展现 了 如 何 通过 Java 配 置 启用 基于 代理 的 Web 消 妃 功 


能 : 








程序 清单 18.5 @EnableWebSocketMessageBroker 注 和 解 能 够 在 
WebSocket 之 上 启用 STOMP 


package marcopolo 

import org.springframework.context.annotation.Configuration; 
config.annotation. 
tractWebSocketMessageBrokerConfigurer; 


import org.springframework .we 






import org.springframework.web.socket.config.annotation. 
EnableWebSocketMessageBroker; 
import org.springframework.web.socket.config,.annotation. 


StompEndpointRegistry; 
@Configuration 
@EnableWebSocketMessageBroker < 一 启用 STOMP 消息 
public class WebSocketStompConfig 


extends AbstractWebSocketMessageBrokerConfigurer { 


&Override 


public void registe 和 ipoint SLOMAN SCY registry) { 
registry. aaaR nAdpoint ("/marcopolo") .withSockJS!(); 2 为 “/marcopolo” 
} 路 径 启用 SockJS 

GoOverride 功能 

public void ER TM Mt et registry) { 
te eile et et "ker ("/queue "jtopic 
registry.setApplicationDestinationPprefixes!("/app" 

} 


与 程序 清单 18.2 中 的 配置 进行 对 比 ，WebSocketStompConfig 使 用 了 

@EnableWebSocketMessageBroker 注 解 。 这 表明 这 个 配置 类 不 仅 配 置 

了 WebSocket， 还 配置 了 基于 代理 的 STOMP 消 轧 。 它 重 载 了 

rea sterStompEndpoints() 方 法 ， 将 “/marcopolo” 注 册 为 STOMP 端 

上 这 个 路 径 与 之 前 发 送 和 接收 消息 的 目的 地 路 径 有 所 不 同 。 这 是 一 个 
出 点 ， 客 户 端 在 订阅 或 发 布 消息 到 目的 地 路 径 前 ， 要 连接 该 端点 。 


WebSsocketSstompConfig 还 通过 重 载 configureMessageBroker() 方 法 
配置 了 上 简单 的 消息 代理 。 这 个 方法 是 可 选 的 ， 如 果 不 重 载 它 的 话 ， 
将 会 自动 配置 一 个 简单 的 内 存 消息 代理 ， 用 它 来 处 理 以 “ytopic" 为 前 组 的 
消息 。 但 是 在 本 例 中 ， 我 们 重 载 了 这 个 方法 ， 所 以 消 恩 代理 将 会 处 理 前 
组 为 ”topic" 和 “queue” 的 消息 。 除 此 之 外 ， 发 往 应 用 程序 的 消息 将 会 带 
有 “/app” 前 级 。 图 18.2 展 现 了 这 个 配置 中 的 消息 流 。 
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MessageHandler 









Cr O 


ltopic 
/queue 








destination:/app/marco 

















/topic 


SimpleBroker 
/queue 


MessageHandler 


destination:/topic/polo 


MESSAGE [> 
destination:/topic/polo 
响应 通道 ( 


图 18.2 ” ”Spring 简单 的 TOMP 代 理 是 基于 内 存 的 ， 它 模拟 了 STOMP 代 理 的 多 项 功能 


当 消 息 到 达 时 ， 目 的 地 的 前 级 将 会 决定 消 恩 该 如 何 处 理 。 在 图 18.2 中 ， 
应 用 程序 的 目的 地 以 “/app” 作 为 前 经， 而 代理 的 目的 地 

以 “/topic” 和 “/queue” 作 为 前 级 。 以 应 用 程序 为 目的 地 的 消 因 将 会 直接 路 
由 到 带 有 @MessageMapping 注 解 的 控制 器 方法 中 。 而 发 送 到 代理 上 的 
消息 ， 其 中 也 包括 @MessageMapping 注 解 方 法 的 返回 值 所 形成 的 消 
上 妃 ， 将 会 路 由 到 代理 上 ， 并 最 终 发 送 到 订阅 这 些 目的 地 的 客户 端 。 


启用 STOMP 代 理 中 继 


对 于 初学 来 讲 ， 简 单 的 代理 是 很 不 错 的 ， 但 是 它 也 有 一 些 限制 。 尽 管 它 
模拟 了 STOMP 消 息 代 理 ， 但 是 它 只 文 持 STOMP 命 令 的 子 集 。 因 为 它 是 
基于 内 存 的 ， 所 以 它 并 不 适合 集群 ， 因 为 如 果 集 群 的 话 ， 每 个 节点 也 只 
能 管理 自己 的 代理 和 自己 的 那 部 分 消息 。 


对 于 生产 环境 下 的 应 用 来 说 ， 你 可 能 会 希望 使 用 真正 文 持 SIOMP 的 代 
理 来 支撑 WebSocket 消 息 ， 如 RabbitMQ 或 ActiveMQ。 这 样 的 代理 提供 了 
可 扩展 性 和 健壮 性 更 好 的 消息 功能 ， 当 然 它 们 也 会 完整 文 持 STIOMP 命 
令 。 我 们 需要 根据 相关 的 文档 来 为 STOMP 搭 建 代 理 。 搭 建 束 绪 之 后 ， 
就 可 以 使 用 STOMP 代 理 来 蔡 换 内 存 代理 了 ， 只 需 按 照 如 下 方式 重 

载 configureMessageBroker() 方 法 即 可 : 












































@Override 

public void configureMessageBroker(MessageBrokerRegistry registry) { 
registry.enableSstompBrokerRelay("/topic", "/queue"); 
registry.setApplicationDestinationprefixes("/app"); 


DJ 


上 述 configureMessageBroker() 方 法 的 第 一 行 代 码 启用 了 STOMP 代 
理 中 继 (broker relay) 功能 ， 并 将 其 目的 地 前 级 设置 

为 “/topic” 和 “queue”。 这 样 的 话 ，Spring 就 能 知道 所 有 目的 地 前 绥 

为 “/topic” 或 “queue” 的 消息 都 会 发 送 到 STOMP 代 理 中 。 根 据 你 所 选择 的 
STOMP 代 理 不 同 ， 目 的 地 的 可 选 前 缀 也 会 有 所 限制 。 例 如 ，RabbitMQ 
只 允许 目的 地 的 类 型 为 temp- 
queue”、“/exchange”、“/topic”、“/gueue”、“/amq/queue” 和 和 “/reply- 


queue”。 请 参阅 代理 的 文档 来 了 解 所 支持 的 目的 地 类 型 及 其 使 用 场景 。 


除了 目的 地 前 级 ， 在 第 二 行 的 configureMessageBroker() 方 法 中 将 应 
用 的 前 级 设置 为 “/app”"。 所 有 目的 地 以 “Japp” 打 涉 的 消息 都 将 会 路 由 到 
EP ne 而 不 会 发 布 到 代理 队列 或 主题 








图 18.3 阐 述 了 代理 中 继 如 何 应 用 于 Spring 的 STOMP 消 息 处 理 之 中 。 我 们 
可 以 看 到 ， 关 键 的 区 别 在 于 这 里 不 再 模拟 STOMP 代 理 的 功能 ， 而 是 由 
代理 中 继 将 消息 传送 到 一 个 真正 的 消息 代理 中 来 进行 处 理 。 
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图 18.3” ”STOMP 代理 中 继 会 将 STOMP 消 息 的 处 理 委托 给 一 个 真正 的 消息 代理 




















注意 ，enableStompBrokerRelay() 和 
setApplicationDestinationPrefixes() 方 法 都 接收 可 变 长 度 的 
String 参 数 ， 所 以 我 们 可 以 配置 多 个 目的 地 和 应 用 前 级。 例如 : 








@Override 


public void configureMessageBroker(MessageBrokerRegistry registry) { 
registry.enableStompBrokerRelay("/topic", "/queue"); 
registry.setApplicationDestinationprefixes("/app", "/foo0"); 


} 





默认 情况 下 ，STOMP 代 理 中 继 会 假设 代理 监听 localhost 的 61613 端 口 ， 

并 且 客 户 端 的 usemame 和 password 均 为 “guest”。 如 果 你 的 STOMP 代 理 位 
于 其 他 的 服务 器 上 ， 或 者 配置 成 了 不 同 的 客户 端 作 证， 那么 我 们 可 以 在 
启用 STOMP 代 理 中 继 的 时 候 ， 需 要 配置 这 些 细节 信息 : 


@Override 
public void configureMessageBroker(MessageBrokerRegistry registry) { 


registry.enableStompBrokerRelay("/topic", "/queue") 
.SetRelayHost("rabbit.someotherserver") 


.SetRelayPort(62623) 

.SetClientLogin("marcopolo") 

.SetClientPpasscode("letmein81"); 
registry.setApplicationDestinationprefixes("/app", "/foo0o"); 


} 





以 上 的 这 个 配置 调整 了 服务 器 、 端 口 以 及 凭证 信息 。 但 是 ， 并 不 是 必须 
要 配置 所 有 的 这 些 选项 。 例 如 ， 如 果 你 只 想 修 改 中 继 端 口 ， 那 么 可 以 只 
调用 setRelayHost() 方 法 ， 在 配置 中 不 必 使 用 其 他 的 Setter 方 法 。 


现在 ，Spring 已 经 配置 就 纤 ， 可 以 用 来 处 理 STOMP 消 息 了 。 
18.3.2 ”处 理 来 自 客 户 端的 STOMP 消 息 


我 们 在 第 5 章 已 经 学 习 过 ，Spring MVC 为 处 理 HTTP Web 请 求 提供 了 面 
向 注解 的 编程 模型 。@RequestMapping 是 Spring MVC 中 最 著名 的 注 
解 ， 它 会 将 HTTP 请 求 映 射 到 对 请 求 进行 处 理 的 方法 上 。 在 第 16 章 ， 我 
们 也 曾经 看 到 相同 的 编程 模型 扩展 到 了 RESTful 的 资源 处 理 中 。 


STOMP 和 WebSocket 更 多 的 是 关于 异步 消息 ， 与 HITP 的 请 求 - 啊 应 方式 
有 所 不 同 。 但 是 ，Spring 提 供 了 非常 类 似 于 Spring MVC 的 编程 模型 来 处 
理 STOMP 消 息 。 它 非常 地 相似 ， 以 至 于 对 STOMP 消 息 的 处 理 器 方法 也 
会 包含 在 带 有 @Controller 注 解 的 类 中 。 


Spring 4.0 引 入 了 @MessageMapping 注 和 解 ， 它 用 于 STOMP 消 息 的 处 理 ， 














类 似 于 Spring MVC 的 @RequestMapping 注 解 。 当 消息 抵达 某 个 特定 的 
目的 地 时 ， 带 有 @MessageMapping 注 解 的 方法 能 够 处 理 这 些 消息 。 例 
如 ， 考 虑 如 下 程序 清单 中 的 控制 器 类 。 


程序 清单 18.6 ”借助 @MessageMapping 注 解 能 够 在 控制 器 中 处 理 
STOMP 消 息 








@Controller 


public class MarcoController { 


private static final Logger logger = 


外 理 必 年 
LoggerFactory.getLogger (MarcoController.class); 处 理发 往 
“/app/marco 
@MessageMapping ("/marco") 目的 地 的 消息 


public void handleShout (Shout incoming) { 


logger.info{"Received message: " + incoming.getMessage{()); 








乍 一 看 上 去 ， 它 非常 类 似 于 其 他 的 Spring MVC 控 制 器 类 。 它 使 用 了 
Q@Controller 注 解 ， 所 以 组 件 扫描 能 够 找到 它 并 将 其 注册 为 bean。 就 像 
其 他 的 @Controller 类 一 样 ， 它 也 包含 了 处 理 器 方法 。 


但 是 这 个 处 理 器 方法 与 我 们 之 前 看 到 的 有 一 点 区 别 。handleShout() 方 
法 没有 使 用 @RequestMapping 注 解 ， 而 是 使 用 了 @MessageMapping 注 
解 。 这 表示 handleShout() 方 法 能 够 处 理 指定 目的 地 上 到 达 的 消息 。 在 
本 例 中 ， 这 个 目的 地 也 就 是 “/app/marco”(“/app” 前 级 是 隐 伟 的， 因为 我 
们 将 其 配置 为 应 用 的 目的 地 前 级 〉。 


因为 handleShout() 方 法 接收 一 个 shout 参 数 ， 所 以 Spring 的 某 一 个 消 
居 转 换 右 会 将 STOMP 消 恩 的 负载 转换 为 shhout 对 象 。Shout 类 非常 人 简 
单 ， 它 是 只 具有 一 个 属性 的 JavaBean， 包 含 了 消息 的 内 容 : 





package marcopolo; 
public class Shout { 
private String message; 
public String getMessage() { 
return message; 


public void setMessage(String message) { 


this.message = message; 
} 
} 


因为 我 们 现在 处 理 的 不 是 HTTP， 所 以 无 法 使 用 Spring 的 
HttpMessageConverter 实 现 将 负载 转换 为 Shout 对 象 。Spring 4.0 提 供 
了 几 个 消息 转换 器 ， 作 为 其 消息 API 的 一 部 分 。 表 18.1 描 述 了 这 些 消 息 
转换 器 ， 在 处 理 STOMP 消 恩 的 时 候 可 能 会 用 到 它们 。 


表 18.1 Spring 能 够 使 用 某 一 个 消息 转换 器 将 消息 负载 转换 为 Java 类 型 


消息 转换 器 


ByteArrayMessageConverter 





























实现 MIME 类 型 为 “application/octet-stream” 的 消息 
与 byte[] 之 间 的 相互 转换 





实现 MIME 类 型 为 application/json” 的 消息 与 Java 





MappingJackson2MessageConverter 对 象 之 间 的 相互 转换 


StringMessageConverter ee 的 消 思 写 String 之 间 





假设 handleShout() 方 法 所 处 理 消息 的 内 容 类 

为 “application/json”( 这 应 该 是 一 人 安全 的 假说 因为 Shout 不 
是 byte[] 和 String) ，MappingJackson2MessageConverter 会 负责 
将 JSON 消 息 转 换 为 Shout 对 象 。 就 像 在 HTTP 中 对 应 的 
MappingJackson2HttpMessageConverter 一 

样 ， MappingJackson2MessageConverter 会 会 将 其 任务 委托 给 底层 的 
Jackson 2 JSON 处 理 器 。 默 认 情 况 下 ，Jackson 会 会 使 用 反射 将 JSON 属 性 映 
出 为 Java 对 象 的 属性 。 尽管 在 本 例 中 没有 必要 ， 但 是 我 们 可 以 通过 在 
Java 类 型 上 使 用 Jackson 注 解 ， 影 响 具 体 的 转换 行为 。 


处 理 订阅 








除了 @MessagingMapping 注 解 以 外 ，Spring 还 提供 了 
Q@SsubscribeMapping 注 解 。 与 GOMessagingMapping 注 解 方法 类 似 ， 当 


收 到 STOMP 订 阅 消 息 的 时 候 ， 带 有 @subscribeMapping 注 解 的 方法 将 
会 触发 。 


很 重要 的 一 点 ， 与 @MessagingMapping 方 法 类 

似 ，@SubscribeMapping 方 法 也 是 通过 
AnnotationMethodMessageHandler 接 收 消息 的 (如 图 18.2 和 图 18.3 所 
示 ) 。 按 照 程 序 清单 18.5 的 配置 ， 这 融 意 味 痢 QsubscribeMapping 方 法 
只 能 处 理 目 的 地 以 %app” 为 前 缀 的 消息 。 


这 可 能 看 上 去 有 些 诡异 ， 因 为 应 用 发 出 的 消息 都 会 经 过 代理 ， 目 的 地 要 
以 /topic” 或 “queue" 打 头 。 客 户 端 会 订阅 这 些 目的 地 ， 而 不 会 订阅 前 绥 
为 app” 的 目的 地 。 如 果 客 户 问 订 阅 “%topic” 和 “queue” 这 样 的 目的 地 ， 
那么 @SubscribeMapping 方 法 也 就 无 法 处 理 这 样 的 订阅 了。 如 果 是 这 
样 的话 ，@SubscribeMapping 有 什么 用 处 呢 ? 


@SubscribeMapping 的 主要 应 用 场景 是 实现 请 求 -回应 模式 。 在 请 求 - 回 
应 模式 中 ， 客 户 端 订阅 某 一 个 目的 地 ， 然 后 预期 在 这 个 目的 地 上 获得 一 
个 一 次 性 的 响应 。 


例如 ， 考 虑 如 下 @SubscribeMapping 注 解 标注 的 方法 : 


@SubscribeMapping({"/marco"}) 
public Shout handleSubscription() { 
Shout outgoing = new Shout(); 


outgoing.setMessage("Polo!"); 
return outgoing; 


} 





可 以 看 到 ，handleSubscription() 方 法 使 用 了 @SubscribeMapping 
注解 ， 用 这 个 方法 来 处 理 对 “/app/marco” 目 的 地 的 订阅 

(与 @MessageMapping 类 似 ，“/app” 是 隐 含 的 ) 。 当 处 理 这 个 订阅 
时 ，handleSubscription() 方 法 会 产生 一 个 输出 的 Shout 对 象 并 将 其 
返回 。 然 后 ，Shout 对 象 会 转换 成 一 条 消 轧 ， 并 且 会 按照 客户 端 订 阅 时 
相同 的 目的 地 发 送 回 客户 端 。 


如 果 你 觉得 这 种 请 求 - 回 应 模式 与 HTTP GET 的 请 求 -响应 模式 并 没有 太 大 
差别 的 话 ， 那 么 你 基本 上 是 正确 的 。 但 是 ， 这 里 的 关键 区 别 在 于 HTTP 
GET 请 求 是 同步 的 ， 而 订阅 的 请 求 -回应 模式 则 是 异步 的 ， 这 样 客户 端 能 
够 在 回应 可 用 时 再 去 处 理 ， 而 不 必 等 符 。 





编写 JavaScript 客 户 端 


handleSshout() 方 法 已 经 可 以 处 理发 送 过 来 的 消息 了 。 现 在 ， 我 们 需要 
的 就 是 发 送 消息 的 客户 端 。 


如 下 的 程序 清单 展现 了 一 些 JavaScript 客 户 端 代 码 ， 它 会 连 
接 “/marcopolo" 端 点 并 发 送 “Marcol” 消 息 。 


程序 清单 18.7 ”借助 STOMP 库 ， 通 过 JavaScript 发 送 消息 


Var url = 'http://' + window.location.host + ‘'/stomp/marcopolo'; 
var sock = new SockJS (url); 创建 SockJS 连接 
Var stomp = Stomp.over (sock); - 创建 STOMP 客户 端 
var payload JSON.stringif messe ag J 
stomp.connect{'guest', 'guest', function(frame) { < 连接 STOMP 端点 

t end("/marco", {}, payload) :一 发 送 消息 


与 我 们 之 前 的 JavaScript 客 户 端 样 例 类 似 ， 在 这 里 首先 针对 给 定 的 URL 创 
建 一 个 Sock]JS 实 例 。 在 本 例 中 ，URL 引 用 的 是 程序 清单 18.5 中 所 配置 的 
STOMP 端 点 〈 不 包括 应 用 的 上 下 文 路 径 %stomp”) 。 


但 是 ， 这 里 的 区 别 在 于 ， 我 们 不 再 直接 使 用 SockJS， 而 是 通过 调 
用 Stomp .over(sock) 创 建 了 一 个 STOMP 客 户 端 实例 。 这 实际 上 封装 了 
SockJS， 这 样 就 能 在 WebSocket 连 接 上 发 送 STOMP 消 息 。 


接 下 来 ， 我 们 使 用 STOMP 进 行 连接 ， 假 设 连接 成 功 ， 然 后 发 送 带 有 
JSON 人 负载 的 消息 到 名 为 “marco” 的 目的 地 。 往 send() 方 法 传递 的 第 二 
个 参数 是 一 个 头 信息 的 Map， 它 会 包含 在 STOMP 的 帧 中 ， 不 过 在 这 个 例 
子 中 ， 我 们 没有 提供 任何 参数 ，Map 是 空 的 。 


现在 ， 我 们 有 了 能 够 发 送 消息 到 服务 器 的 客户 端 ， 以 及 用 来 处 理 消 妃 的 
服务 端 处 理 器 方法 。 这 是 一 个 好 的 开端 ， 但 是 你 可 能 已 经 发 现 这 都 是 单 
问 的 。 接 下 来 ， 我 们 让 服务 器 发 出 的 声音 ， 看 一 下 如 何 发 送 消息 给 客户 
端 。 


18.3.3 ”发 送 消息 到 客户 端 


到 目前 为 止 ， 客 户 端 负责 了 所 有 的 消息 发 送 ， 服 务 器 只 能 监听 这 些 消 
轧 。 对 于 WebSocket 和 STOMP 来 说 ， 这 是 一 种 合法 的 用 法 ， 但 是 当 你 考 





虑 使 用 WebSocket 的 时 候 ， 所 设想 的 使 用 场景 巩 怕 并 非 如 此 。 
WebSocket 通 党 视 为 服务 器 发 送 数据 给 浏览 器 的 一 种 方式 ， 采 用 这 种 方 
式 所 发 送 的 数据 不 必 位 于 HTTP 请 求 的 响应 中 。 使 用 Spring 和 
WebSocket/STOMP 的 话 ， 该 如 何 与 基于 浏览 器 的 客户 问 通 信 呢 ? 


Spring 提 供 了 两 种 发 送 数据 给 客户 端的 方法 : 


。 作为 处 理 消息 或 处 理 订阅 的 附 囊 结 
。 使 用 消 姑 模板 。 


我 们 已 经 了 解 了 一 些 处 理 消息 和 处 理 订阅 的 方法 ， 所 以 首先 看 一 下 如 何 
通过 这 些 方法 发 送 消息 给 客户 端 。 然 后 ， 再 看 一 下 Spring 的 
SimpMessagingTemplate， 它 能 够 在 应 用 的 任何 地 方 发 送 消 息 。 


在 处 理 消 息 之 后 ， 发 送 消息 
程序 清单 18.6 中 ，handleshout() 只 是 简单 地 返回 void。 它 的 任务 就 是 
处 理 消息 ， 并 不 需要 给 客户 端 回应 。 


如 果 你 想 要 在 接收 消息 的 时 候 ， 同 时 在 响应 中 发 送 一 条 消息 ， 那 么 需要 
做 的 仅仅 是 将 内 容 返 回 束 可 以 了 ， 方 法 签名 不 再 是 使 用 void。 例 如 ， 如 
果 你 想 发 送 *Polo! 消 息 作 为 "Marcop 消息 的 回应 ， 那 么 只 需 

将 handleShout() 修 改 为 如 下 所 示 : 











@MessageMapping("/marco") 
public Shout handleShout(Shout incoming) { 
logger.info("Received message: ”+ incoming.getMessage() ); 


Shout outgoing = new Shout(); 
outgoing.setMessage("Polo!"); 
return outgoing; 


} 


在 这 个 新 版 本 的 handleShout() 方 法 中 ， 会 返回 一 个 新 的 Shout 对 象 。 
通过 简单 地 返回 一 个 对 象 ， 处 理 器 方法 同时 也 变 成 了 发 送 方法 。 

当 @MessageMapping 注 解 标 示 的 方法 有 返回 值 的 时 候 ， 返 回 的 对 象 将 
2 (通过 消息 转换 器 ) 并 放 到 STOMP 帧 的 负载 中 ， 然 后 发 送 
< 消 轧 飞 理 。 


默认 情况 下 ， 帧 所 肥 往 的 目的 地 会 与 触发 处 理 句 方法 的 目的 地 相同 ， 只 





不 过 会 添加 上 “%topic”" 前 绥 。 就 本 例 而 言 ， 这 意味 着 handleSshout() 方 
法 所 返回 的 Shout 对 象 会 写 入 到 STOMP 帧 的 负载 中 ， 并 发 布 

到 “/topic/marco” 目 的 地 。 不 过 ， 我 们 可 以 通过 为 方法 添加 @sendTo 注 
解 ， 重 载 目的 地 : 


@MessageMapping("/marco") 

@SendTo("/topic/shout") 

public Shout handleShout(Shout incoming) { 
logger.info("Received message: ”+ incoming.getMessage() ); 


Shout outgoing = new Shout() ; 
outgoing.setMessage("Polo!"); 
return outgoing; 


} 





按照 这 个 QsendTo 注 解 ， 消 息 将 会 发 布 到 “topic/shout"。 所 有 订阅 这 个 
主题 的 应 用 〈 如 客户 端 ) 都 会 收 到 这 条 消息 。 


这 样 的 话 ，handleshout() 在 收 到 一 条 消息 的 时 候 ， 作 为 啊 应 也 会 发 送 
一 条 消息 。 按 照 类 似 的 方式 ，@subscribeMapping 注 解 标注 的 方式 也 

能 发 送 一 条 消息 ， 作 为 订阅 的 回应 。 例 如 ， 通 过 为 控制 器 添加 如 下 的 方 
法 ， 当 客户 端 订阅 的 时 候 ， 将 会 发 送 一 条 Shout 信 息 : 








@SubscribeMapping("/marco") 
public Shout handleSubscription() { 
Shout outgoing = new Shout(); 


outgoing.setMessage("Polo!"); 
return outgoing; 


} 





这 里 的 gsubscribeMapping 注 解 表明 当 客 户 端 订 

阅 “/app/marco”(“/app” 是 应 用 目的 地 的 前 级 ) 目的 地 的 时 候 ， 将 会 调 
用 handlesubscription() 方 法 。 它 所 返回 的 Shout 对 象 将 会 进行 转换 
并 发 送 回 客户 端 。 
Q@SubscribeMapping 的 区 别 在 于 这 里 的 Shout 消 息 将 会 直接 发 送 给 客户 
端 ， 而 不 必 经 过 消息 代理 。 如 果 你 为 方法 添加 @sendTo 注 解 的 话 ， 那 么 
消息 将 会 发 送 到 指定 的 目的 地 ， 这 样 会 经 过 代理 。 


在 应 用 的 任意 地 方 发 送 消 息 





@MessageMapping 和 @SubscribeMapping 提 供 了 一 种 很 简单 的 方式 来 
发 送 消 息 ， 这 是 接收 消息 或 处 理 订 阅 的 附带 结果 。 不 过 ，Spring 的 
SimpMessagingTemplate 能 够 在 应 用 的 任何 地 方 发 送 消 息 ， 甚 至 不 必 
以 首先 接收 一 条 消 恕 作为 前 提 。 


使 用 simpMessagingTemplate 的 最 简单 方式 是 将 它 (或 者 其 接口 
SimpMessage-Sendingoperations) 自动 装配 到 所 需 的 对 象 中 。 


为 了 将 这 一 切 付 诸 实施 ， 我 们 重新 看 一 下 Spittr 的 首页 ， 为 其 提供 实时 
的 Spittle feed 功能 。 按 照 其 当前 的 写法 ， 控 制 器 会 处 理 首页 的 请 求 ， 将 
最 新 的 Spittle 列 表 获 取 到 ， 并 将 其 放 到 模型 中 ， 然 后 泻 染 到 用 户 的 浏 
蜂 器 中 。 尺 管 这 样 运行 起 来 也 不 错 ， 但 是 它 并 没有 提供 Spittle 更 新 的 
实时 feed。 如 果 用 户 想 要 看 一 个 更 新 的 Spittle feed， 那 必须 要 在 浏览 
器 中 刷新 页 面 。 


我 们 不 必要 求 用 户 刷新 页 面 ， 而 是 让 首页 订阅 一 个 STOMP 主 题 ， 
在 Spittle 创 建 的 时 候 ， 该 主题 能 够 收 到 Spittle 更 新 的 实时 feed。 在 首页 
中 ， 我 们 需要 添加 如 下 的 JavaScript 代 码 块 ; 

















<script> 
var sock = new SockJS('spittr'); 
var stomp = Stomp.over(sock); 


stomp.connect('guest', 'guest', function(frame) { 
console.1log('Connected'); 
stomp.subscribe("/topic/spittlefeed", handleSpittle); 
}); 


function handleSpittle(incoming) { 
var spittle = JSON.parse(incoming.body); 
console.log('Received: ', spittle); 
var source = $("#spittle-template").html(); 
var template = Handlebars.compile(source); 
var spittleHtml = template(spittle); 
$('.spittleList').prepend(spittleHtml); 

} 


</script> 





与 之 前 的 样 例 一 样 ， 我 们 首先 创建 了 SockJS 实 例 ， 然 后 基于 该 SockJS 
实例 创建 了 stomp 实 例 。 在 连接 到 STOMP 代 理 之 后 ， 我 们 订阅 
了 “topic/spittlefeed”， 并 指定 当 消 息 达 到 的 时 候 ， 由 handleSspittle( ) 





函数 来 处 理 Spittle 更 新 。handleSspittle() 函 数 会 将 传 入 的 消息 体 解析 
为 对 应 的 JavaScript 对 象 ， 然 后 使 用 Handlebars 库 将 Spittle 数 据 泻 染 为 
HTML 并 插入 到 列表 中 。Handlebars 模 板 定义 在 一 个 单独 的 <script> 标 
签 中 ， 如 下 所 示 : 


<script id="spittle-template” type="text/x-handlebars-template"> 
<1i id="preexist"> 
<div class="spittleMessage">{{message}}</div> 
<div> 


<Span class="spittleTime">{{time}}</span> 
«<span class="spittleLocation">({{latitude}}, {{longitude}})</span> 
</div> 
</1i> 
</script> 





在 服务 器 端 ， 我 们 可 以 使 用 SsimpMessagingTemplate 将 所 有 新 创建 的 
Spittle 以 消息 的 形式 发 布 到 “/topic/spittlefeed” 主 题 上 。 如 下 程序 清单 展 
现 的 SpittleFeedServiceImpl 就 是 实现 该 功能 的 简单 服务 : 

程序 清单 18.8 ”SimpMessagingTemplate 能 够 在 应 用 的 任何 地 方 发 布 消 
自 


4DO 


package ttr; 

import org.springframework.beans.factory.annotation.Autowired; 

import org.springframework.messaging.simp.SimpMessageSendingOperations; 
import org.springframework.stereotype.Service; 

@Servi 

p\ Le t FeedService 


注入 消息 模板 





配置 Spring 文 持 STOMP 的 一 个 副作用 就 是 在 Spring 应 用 上 下 文中 已 经 包 
含 了 SimpMessagingTemplate。 因 此 ， 我 们 在 这 里 没有 必要 再 创建 新 
的 实例 。Spittle-FeedSserviceImp1 的 构造 器 使 用 了 @Autowired 注 

解 ， 这 样 当 创建 spittleFeedSservice-Imp1 的 时 候 ， 就 能 注 

入 SimpMessagingTemplate (VSimpMessageSendingOperations 的 


Sa 


发 送 sSpittle 消 息 的 地 方 在 broadcastSpittle() 方 法 中 。 它 在 注入 的 
SimpMessageSendingOperations 上 调用 了 convertAndSend() 方 法 ， 
将 Spitt1le 转 换 为 消息 ， 并 将 其 发 送 到 “topic/spittlefeed” 主 题 上 。 如 果 
你 觉得 convertAndsend () 方 法 看 起 来 很 眼熟 的 话 ， 那 是 因为 它 模拟 了 
JmsTemplate 和 RabbitTemplate 所 提供 的 同名 方法 。 


不 管 我 们 通过 convertAndSend() 方 法 ， 还 是 借助 处 理 器 方法 的 结果 ， 
在 发 布 消息 给 STOMP 主 题 的 时 候 ， 所 有 订阅 该 主题 的 客户 端 都 会 收 到 
消息 。 在 这 个 场景 下 ， 我 们 希望 所 有 的 客户 端 都 能 及 时 看 到 实时 的 
Spittle feed， 这 种 做 法 是 很 好 的 。 但 有 的 时 候 ， 我 们 希望 发 送 消息 给 
指定 的 用 户 ， 而 不 是 所 有 的 客户 端 。 














18.4 为 目标 用 户 发 送 消 有 息 


到 目前 为 止 ， 我们 所 发 送 和 接收 的 消息 都 是 客户 端 ( 在 Web 浏览 器 中 ) 
和 服务 器 端 之 间 的 ， 并 没有 考虑 到 客户 端的 用 户 。 当 府 

有 @MessageMapping 注 解 的 方法 触发 时 ， 我 们 知道 收 到 了 消息 ， 但 是 
并 不 知道 消息 来 源 于 谁 。 类 似 地 ， 因 为 我 们 不 知道 用 户 是 谁 ， 所 以 消 恩 
会 发 送 到 所 有 订阅 对 应 主题 的 客户 端 上 ， 没 有 办 法 发 送 消息 给 指定 用 
厂 。 

但 是 ， 如 果 你 知道 用 户 是 谁 的 话 ， 那 么 就 能 处 理 与 某 个 用 户 相 关 的 消 
娠 ， 而 不 仪 仪 是 与 所 有 客户 问 相 关联 。 好 消息 是 我 们 已 经 了 解 了 如 何 识 
别 用 户 。 通 过 使 用 与 第 9 章 相 同 的 认证 机 制 ， 我 们 可 以 使 用 Spring 
Security 来 认证 用 户 ， 并 为 目标 用 户 处 理 消 乱 。 


在 使 用 Spring 和 STOMP 消 息 功 能 的 时 候 ， 我 们 有 三 种 方式 利用 认证 用 
户 : 











。 @MessageMapping 和 @SubscribeMapping 标 注 的 方法 能 够 使 
用 Principal 来 获取 认证 用 户 ; 
。 QMessageMapping、@SubscribeMapping 和 和 @MessageException 
方法 返回 的 值 能 够 以 消息 的 形式 发 送 给 认证 用 户 ; 
e。SimpMessagingTemplate 能 够 发 送 消息 给 特定 用 户 。 


我 们 首先 看 一 下 前 两 种 方式 ， 它 们 都 能 让 控制 占 的 消 恩 处 理 方法 使 用 针 
对 特定 用 户 的 消息 。 


18.4.1 在 控制 右 中 处 理 用 户 的 消 奶 


如 前 所 述 ， 在 控制 器 的 @MessageMapping 或 @SubscribeMapping 方 法 
中 ， 处 理 消 息 时 有 两 种 方式 了 解 用 户 信息 。 在 处 理 器 方法 中 ， 通 过 简单 
地 添加 一 个 Principal 参 数 ， 这 个 方法 就 能 知道 用 户 是 谁 并 利用 该 信息 
关注 此 用 户 相关 的 数据 。 除 此 之 外 ， 处 理 器 方法 还 可 以 使 

用 @sendToUser 注 解 ， 表 明 它 的 返回 值 要 以 消息 的 形式 发 送 给 某 个 认证 
用 户 的 客户 端 〈 只 发 送 给 该 客户 端 ) 。 


为 了 阐述 该 功能 ， 让 我 们 编写 一 个 控制 器 方法 ， 它 会 根据 传 入 的 消息 创 











建新 的 Spittle 对 象 ， 并 发 送 一 个 回应 ， 表 明 Spitt1le 已 经 保存 成 功 。 

如 果 你 觉得 这 个 场景 很 熟悉 的 话 ， 那 是 因为 在 第 16 章 我 们 以 REST 端 点 

的 形式 实现 了 和 它 。 但 是 REST 请 求 是 同步 的 ， 当 服务 器 处 理 的 时 候 ， 客 

户 端 必须 要 等 每 。 通 过 将 Spittle 太 送 为 STOMP 消 忠 ， 我 们 可 以 充分 发 
挥 STOMP 消 息 异 步 的 优势 。 


考虑 如 下 的 handleSpittle() 方 法 ， 它 会 处 理 传 入 的 消息 并 将 其 存储 
为 Spittle: 





@MessageMapping("/spittle") 
@SendToUser("/queue/notifications") 
public Notification handleSpittle( 

Principal principal, SpittleForm form) { 


Spittle spittle = new Spittle( 


principal.getName(), form.getText(), new Date()); 


spittleRepo.save(spittle); 


return new Notification("Saved Spittle"); 


} 





可 以 看 到 ，handleSpittle( ) 方 法 接受 Principal 对 象 和 
SpittleForm 对 象 作为 参数 。 它 使 用 这 两 个 对 象 创建 一 个 spittle 实 例 
并 借助 SspittleRepository 将 实例 保存 起 来 。 最 后 ， 它 返回 一 个 新 的 
Notification， 表 明 Spittle 已 经 保存 成 功 。 


当然 ， 比 起 方法 内 部 的 功能 ， 这 个 方法 体外 部 所 做 事情 也 许 更 让 我 们 感 
兴趣 。 因 为 这 个 方法 使 用 了 @MessageMapping 注 解 ， 因 此 当 有 发 

往 “%/app/spittle” 目 的 地 的 消息 到 达 时 ， 该 方法 就 会 触发 ， 并 且 会 根据 消 
恩 创 建 SpittleForm 对 象 ， 如 果 用 户 已 经 认证 过 的 话 ， 将 会 根据 
STOMP 帧 上 的 头 信 息 得 到 Principal 对 象 。 


但 是 ， 需 要 特别 关注 的 是 ， 返 回 的 Notification 到 哪里 去 

了 。@sendToUser 注 解 指定 返回 的 Notification 要 以 消息 的 形式 发 送 
到 “/queue/notifications” 目 的 地 上 。 在 表面 上 ，“/gqueue/notifications” 并 没 
有 与 特定 用 户 关 联 。 但 因为 这 里 使 用 的 是 @SendToUser 注 解 而 不 

是 @SendTo， 所 以 就 会 发 生 更 多 的 事情 了 。 


为 了 理解 Spring 如 何 发 布 消 息 ， 让 我 们 先 退 后 一 步 ， 看 一 下 针对 控制 器 





方法 发 布 Notification 对 象 的 目的 地 ， 客 户 端 该 如 何 进行 订阅 。 考 虑 
如 下 的 这 行 JavaScript 代 码 ， 它 订阅 了 一 个 用 户 特定 的 目的 地 : 


stomp.subscribe("/user/queue/notifications", handleNotifications); 





注意 ， 这 个 目的 地 使 用 了 “/user* 作 为 前 级 ， 在 内 部 ， 以 “/user” 作 为 前 级 
的 目的 地 将 会 以 特殊 的 方式 进行 处 理 。 这 种 消息 不 会 通过 
AnnotationMethodMessageHandler 〈 像 应 用 消息 那样 ) 来 处 理 ， 也 
不 会 通过 simpleBrokerMessageHandler 

或 stompBrokerRelayMessageHandler 〈 像 代理 消息 那样 ) 来 处 理 ， 
以 “/user” 为 前 级 的 消息 将 会 通过 UserDestinationMessageHandler 进 


Fen = 
行 处 理 ， 如 图 18.4 所 示 。 
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18.4 用 户 消 息 流 会 通过 UserDestinationMessageHandler 进 行 处 理 ， 它 会 将 消息 重 路 由 到 某 个 
用 户 独 有 的 目的 地 上 











UserDestinationMessageHandler 的 主要 任务 是 将 用 户 消息 重新 路 由 
到 某 个 用 户 独 有 的 目的 地 上 。 在 处 理 订 阅 的 时 候 ， 它 会 将 目标 地 址 中 
的 “user” 前 绥 去 掉 ， 并 基于 用 户 的 会 话 添 加 一 个 后 缀 。 例 如 ， 

对 “/user/queue/notifications” 的 订阅 最 后 可 能 路 由 到 名 

为 “/queue/notifications-user6hr83v6t” 的 目的 地 上 。 


在 我 们 的 样 例 中 ，handleSpittle() 方 法 使 用 了 





@SendToUser("/queue/notifications") 注 解 。 这 个 新 的 目的 地 

以 “/queue” 作 为 前 级 ， 根 据 配 置 ， 这 

是 StompBrokerRelayMessageHandler (或 simpleBrokerMessageHal 
要 处 理 的 前 级 ， 所 以 消 恩 接 下 来 会 到 达 这 里 。 最 终 ， 客 户 端 会 订阅 这 个 
目的 地 ， 因 此 客户 端 会 收 到 Notification 消 息 。 


在 控制 器 方法 中 ，@SendToUser 注 解 和 Principal 参 数 是 很 有 用 的 。 但 
是 在 程序 清单 18.8 中 ， 我 们 看 到 借助 消息 模板 ， 可 以 在 应 用 的 任何 位 置 
发 送 消息 。 接 下 来 看 一 下 如 何 使 用 SimpMessagingTemplate 将 消息 发 
送 给 特定 用 户 。 


18.4.2 ”为 指定 用 户 发 送 消 息 


除了 convertAndSend() 以 外 ，SimpMessagingTemplate 还 提供 了 
convertAndSendToUser() 方 法 。 按 照 名 字 就 可 以 判断 出 
来 ，convertAndSendToUser() 方 法 能 够 让 我 们 给 特定 用 户 发 送 消息 。 


为 了 阅 述 该 功能 ， 我 们 要 在 Spittr 应 用 中 添加 一 项 特性 ， 当 其 他 用 户 提 

交 的 Spittle 提 到 某 个 用 户 时 ， 将 会 提醒 该 用 户 。 例 如 ， 如 果 Spittle 
文本 中 包含 “@jbauer”， 那 么 我 们 吏 应 该 发 送 一 条 消息 给 使 用 *jbauer" 用 
户 名 登录 的 客户 端 。 如 下 程序 清单 中 的 broadcast-Spittle() 方 法 使 

用 了 convertAndSendToUser()， 从 而 能 够 提醒 所 谈论 到 的 用 户 。 

















程序 清单 18.9 ”convertAndSendToUser() 能 够 发 送 消 明 给 特定 用 户 


package spittr; 

import java.util.regex.Matcher; 

import java.util.regex.Pattern; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.messaging.simp.SimpMessagingTemplate; 
import org.springframework.stereotype.Service; 


@Service 
public class SpittleFeedServiceImpl] implements SpittleFeedService { 


private SimpMessagingTemplate messaging; 实现 用 户 提 及 
private Pattern pattern = Pattern.compile("\\@(\\S+)"}); 4 功能 的 正则 表达 式 


@Autowired 
Public SpittleFeedServiceImpl (SimpMessagingTemplate messaging) { 
this.messaging = messaging; 


} 
public void broadcastSspittle(Spittle spittle) { 
messaging.convertAndSend{"/topic/spittlefeed", spittle); 


Matcher matcher = pattern.matcher(spittle.getMessage()); 
if {matcher.find{(})) { 


String username = matcher.group{(1):; 发 送 
messaging.convertAndSendToUser ( < 提醒 给 用 户 
username, "/queue/notifications", 


new Notification("You just got mentioned!")); 


在 broadcastSpittle() 中 ， 如 果 给 定 Spittle 对 象 的 消息 中 包含 了 类 似 
于 用 户 名 的 内 容 《〈 也 就 是 以 *@” 开 头 的 文本 ) ， 那 么 一 个 新 的 
Notification 将 会 发 送 到 名 为 “/queue/notifications” 的 目的 地 上 。 
此 ， 如 果 Spittle 中 包含 “@jbauer” 的 话 ，Notification 将 会 发 送 

到 |“/user/jbauer/queue/notifications” 目 的 地 上 。 


18.5 ”处 理 消 息 异 常 


有 时 候 ， 事 情 并 不 会 按照 我 们 预期 的 那样 发 展 。 在 处 理 消息 的 时 候 ， 有 
可 能 会 出 错 并 抛 出 异常 。 因 为 STOMP 消 息 异 步 的 特点 ， 发 送 者 可 能 永 
远 也 不 会 知道 出 现 了 错误 。 除 了 Spring 的 日 志 记 录 以 外 ， 有 异常 有 可 能 会 
丢失 ， 没 有 资源 或 机 会 恢复 。 


在 Spring MVC 中 ， 如 果 在 请 求 处 理 中 ， 出 现 异常 的 

话 ，@ExceptionHandler 方 法 将 有 机 会 处 理 异 毅 。 与 之 类 似 ， 我 们 也 
可 以 在 某 个 控制 器 方法 上 添加 @MessageException-Handler 注 解 ， 让 
它 来 处 理 @MessageMapping 方 法 所 抛 出 的 开 毅 。 


例如 ， 考 虑 如 下 的 方法 ， 它 会 处 理 消息 方法 所 抛 出 的 异 第 : 








@MessageExceptionHandler 
public void handleExceptions(Throwable t) { 


logger.error("Error handling message: " + t.getMessage()); 


} 





按照 最 简单 的 形式 ，@MessageExceptionHandler 标 注 的 方法 能 够 处 理 
消息 方法 中 所 抛 出 的 异常 。 但 是 ， 我 们 也 可 以 以 参数 的 形式 声明 它 所 能 
处 理 的 异常 : 


@MessageExceptionHandler(SpittleException.class) 
public void handleExceptions(Throwable t) { 
logger.error("Error handling message: " + t.getMessage()); 


} 


或 者 ， 以 数组 参数 的 形式 指定 多 个 异常 类 型 





@MessageExceptionHandler( 
{SpittleException.class, DatabaseException.class}) 
public void handleExceptions(Throwable t) { 
logger.error("Error handling message: ”+ t.getMessage()); 








@MessageExceptionHandler(SpittleException.class) 
@SendToUser("/queue/errors") 
public SpittleException handleExceptions(SpittleException e) { 


logger.error("Error handling message: ”+ e.getMessage() ) ; 
return e; 


} 





在 这 里 ， 如 果 抛 出 SpittleException 的 话 ， 将 会 记录 这 个 异常 ， 然 后 
将 其 返回 。 在 18.4.1 小 节 中 ， 我 们 已 经 学 

过 ，UserDestinationMessageHandler 会 重新 路 由 这 个 消息 到 特定 用 
户 所 对 应 的 唯一 路 径 。 





18.6 小结 


如 果 在 应 用 间 发 送 消息 的 话 ， 那 WebSocket 是 一 种 令 人 兴奋 的 通信 方 
式 ， 尤 其 是 如 果 其 中 东 个 应 用 运行 在 Web 浏 览 器 中 更 是 如 此 。 当 编写 存 
在 大 量 交 互 的 Web 应 用 程序 时 ， 它 是 很 重要 的 ， 能 够 实现 从 服务 器 无 颖 
的 发 送 和 接收 数据 。 


Spring 对 WebSocket 的 支持 包括 低层 级 的 API， 它 能 够 让 我 们 使 用 原始 的 
WebSocket 连 接 。 但 是 ，WebSocket 并 没有 在 Web 浏 览 器 、 服 务 器 以 及 网 
络 代 理 上 得 到 广泛 支持 。 因 此 ，Spring 同 时 还 支持 SockJS， 这 个 协议 能 
够 在 WebSocket 不 可 用 的 时 候 提供 备用 的 通信 模式 。 


Spring 还 提供 了 高 级 的 编程 模型 ， 也 就 是 使 用 STOMP 线 路 级 协议 来 处 理 
WebSocket 消 息 。 在 这 个 更 高 级 的 模型 中 ， 能 够 在 Spring MVC 控 制 占 中 
处 理 STOMP 消 息 ， 类 似 于 处 理 HITP 消 息 的 方式 。 


在 过 去 的 两 章 中 ， 我 们 看 到 了 多 种 在 应 用 间 异 步 发 送 消息 的 方式 。 
Spring 还 有 另外 一 种 处 理 异 步 消息 的 方式 。 在 下 一 章 中 ， 我 们 将 会 看 到 
如 何 使 用 Spring 发 送 Email。 




















第 19 章 ”使 用 Spring 发 送 Email 
本 章 内 容 : 


。 配 置 Spring 的 Email 抽象 功能 
。 发 送 丰 富 内 容 的 Email 消 奶 
。 使 用 模板 构建 Email 消息 


量 无 疑问 ，Email 已 经 成 为 稼 见 的 通信 形式 ， 取 代 了 很 多 传统 的 通信 方 
式 ， 如 邮政 邮件 、 电 话 ， 在 一 定 程 度 上 也 替代 了 面对面 的 交流 。Email 
能 够 提供 了 与 第 17 章 中 所 讨论 的 异步 消息 相同 的 收益 ， 只 不 过 发 送 者 和 
接收 者 都 是 实际 的 人 而 已 。 只 要 你 在 邮件 客户 端 上 点 击 “ 发 送 ” 按 钮 ， 就 
可 以 转移 到 其 他 的 任务 中 了 ， 因 为 我 们 知道 接收 者 最 终 将 会 收 到 并 阅读 
(希望 如 此 ) 你 的 Email。 


但 是 ，Email 的 发 送 者 不 一 定 是 实际 的 人 。 有 时 候 ，Email 消 息 是 由 应 用 
程序 发 送 给 用 户 的 。 有 可 能 是 电子 商务 网 站 上 的 订单 确认 邮件 ， 也 有 可 
能 是 银行 账户 某 项 交易 的 自动 提醒 。 不 管 邮 件 的 主题 是 什么 ， 我 们 都 可 
能 需要 开发 发 送 Email 消息 的 应 用 程序 。 幸 好 ， 在 这 个 方面 ，Spring 会 为 
我 们 提供 帮助 。 


在 第 17 章 中 ， 我 们 借助 Spring 对 消息 功能 的 支持 ， 以 排队 任务 的 形式 异 
步 发 送 Spittle 提 醒 给 Spittr 的 其 他 用 户 。 但 是 ， 这 项 任务 并 未 完成 ， 因 为 
没有 发 送 Email 消 息 。 现 在 ， 我 们 将 会 完成 这 项 任务 ， 在 本 章 首 先 会 看 
一 下 Spring 是 如 何 抽象 邮件 发 送 这 一 问题 的 ， 然 后 利用 这 一 抽象 发 送 包 
含 Spittle 提 醒 的 Email 消息 。 

















19.1 配置 Spring 发 送 邮 件 


Spring Email 抽象 的 核心 是 MailSender 接 口 。 顾 名 思 义 ，MailSsender 
的 实现 能 够 通过 连接 Email 服务 器 实现 邮件 发 送 的 功能 ， 如 图 19.1 所 示 。 


邮件 Be 邮件 
Wf 


图 19.1 Spring 的 MailSender 接 口 是 Spring Email 抽象 API 的 核心 组 件 。 
它 把 Email 发 送 给 邮件 服务 器 ， 由 服务 器 进行 邮件 投递 








Spring 自 带 了 一 个 MailSender 的 实现 也 就 是 JavaMailSenderImpl， 它 
会 使 用 JavaMail API 来 发 送 Email。Spring 应 用 在 发 送 Email 之 前 ， 我 们 必 
须要 将 JavaMailsenderImpl 装 配 为 Spring 应 用 上 下 文中 的 一 个 bean。 


19.1.1 配置 邮件 发 送 器 


按照 最 简单 的 形式 ， 我 们 只 需 在 @Bean 方 法 中 使 用 几 行 代码 就 能 
将 JavaMailsenderImp1 配 置 为 一 个 bean: 


@Bean 
public MailSender mailSender(Environment env) { 
JavaMailSenderImpl mailSender = new JavaMailSenderImpl(); 


mailSender.setHost(env.getProperty("mailserver.host")); 
return mailSender; 


} 





属性 host 是 可 选 的 ( 它 默 认 是 底层 JavaMail 会 话 的 主机 〉 ， 但 你 可 能 
望 设置 该 属性 。 它 指定 了 要 用 来 发 送 Email 的 邮件 服务 器 主机 名 。 按 照 
这 里 的 配置 ， 会 从 注入 的 Environment 中 获取 值 ， 这 样 我 们 就 能 在 
Spring 之 外 管理 邮件 服务 器 的 配置 (比如 在 属性 文件 中 ) 。 


默认 情况 下 ，JavaMailsenderImp1 假 设 邮 件 服务 器 监听 25 端 口 〈 标 准 


的 SMTP 痛 口 ) 。 如 宁 你 的 邮件 服务 器 监听 不 同 的 端口 ， 那 么 可 以 使 用 
port 属 性 指定 正确 的 端口 号 。 例 如 : 


@Bean 





public MailSender mailSender(Environment env) { 
JavaMailSenderImpl] mailSender = new JavaMailSenderImpl(); 
mailSender.setHost(env.getProperty("mailserver.host")); 
mailSender.setPort(env.getProperty("mailserver.port")); 
return mailSender; 


} 





类 似 地 ， 如 果 邮 件 服务 器 需要 认证 的 话 ， 你 还 需要 设置 username 和 
password 属 性 : 


@Bean 

public MailSender mailSender(Environment env) { 
JavaMailSenderImpl] mailSender = new JavaMailSenderImpl(); 
mailSender.setHost(env.getProperty("mailserver.host")); 
mailSender.setPort(env.getProperty("mailserver.port")); 
mailSender.setUsername(env.getPproperty("mailserver.username")); 
mailSender.setPassword(env.getPproperty("mailserver.password")); 
return mailSender; 





到 目前 为 止 ，JavaMailsenderImp1 已 经 配置 完成 ， 它 可 以 创建 自己 的 
邮件 会 话 ， 但 是 你 可 能 已 经 在 JNDI 中 配置 了 
javax.mail.Mailsession( 也 可 能 是 你 的 应 用 服务 器 放 在 那里 的 )。 
如 果 这 样 的 话 ， 那 就 没有 必要 为 JavaMailSenderImpl 配 置 详细 的 服务 
器 细节 了 。 我 们 可 以 配置 它 使 用 JNDI 中 已 就 绪 的 MailSession。 


借助 JIndi0bjectFactoryBean， 我 们 可 以 在 如 下 的 @Bean 方 法 中 配置 
一 个 bean， 它 会 从 JNDI 中 查找 MailSession: 





@Bean 

public JndiobJjectFactoryBean mailSession() { 
JndiobJjectFactoryBean jndi = new JndiObjectFactoryBean(); 
jndi.setJndiName("mail/Session"); 


jndi.setproxyInterface(MailSession.class); 
jndi.setResourceRef(true); 
return jndi; 





我 们 已 经 看 到 过 如 何 使 用 Spring 的 <jee:jndi-lookup> 元 素 从 JNDI 中 获 
取 对 象 ， 这 里 可 以 使 用 <jee:jndi-lookup> 来 创建 一 个 bean， 它 引用 
了 JNDI 中 的 邮件 会 话 : 


<jee:jndi-lookup id="mailSession" 





jndi-name="mail/Session" resource-ref="true" /> 


邮件 会 话 准备 就 绪 之 后 ， 我 们 现在 可 以 将 其 装配 到 mailSender bean 中 
了 了 : 


@Bean 
public MailSender mailSender(MailSession mailSession) { 
JavaMailSenderImpl] mailSender = new JavaMailSenderImpl(); 


mailSender.setSession(mailSession); 
return mailSender; 


} 








通过 将 邮件 会 话 装配 到 JavaMailsenderImp1 的 session 属 性 中 ， 我 们 
已 经 完全 葵 换 了 原来 的 服务 器 (以 及 用 户 名 /密码 ) 配置 。 现 在 邮件 会 

话 完全 通过 JNDI 进 行 配 置 和 管理 。JavaMailsenderImp1 能 够 专注 于 发 
送 邮件 而 不 必 自 己 处 理 邮 件 服务 器 了 。 


19.1.2 ”装配 和 使 用 邮件 发 送 器 


邮件 发 送 喜 已 经 配置 完成 ， 现 在 需要 将 其 装配 到 使 用 它 的 bean 中 了 。 在 
Spittr 应 用 程序 中 ， 最 适合 发 送 Email 的 是 spitterEmailServiceImpl 
类 。 这 个 类 有 一 个 mailsender 属 性 ， 它 使 用 了 @Autowired 注 解 : 


@Autowired 
JavaMailSender mailSender; 


当 Spring 将 SpitterEmailserviceImp1 创 建 为 一 个 bean 的 时 候 ， 它 将 查 
找 实 现 了 Mailsender 的 bean， 这 样 的 bean 可 以 装配 到 mailSsender 属 性 
中 。 它 将 会 找到 我 们 在 前 边 配 置 的 mailSsenderbean 并 使 用 

它 。mailSsenderbean 装 配 完 成 后 ， 我 们 束 可 以 构建 和 发 送 Email 了 。 
我 们 想 要 给 Spitter 用 户 发 送 Email 提 示 他 的 朋友 写 了 新 的 Spitle， 所 以 我 
们 需要 一 个 方法 来 有 发送 Email， 这 个 方法 要 接受 Email 地 址 和 Spittle 对 
象 信息 。 如 下 的 sendSimpleSpittleEmail() 方 法 使 用 邮件 发 送 器 完成 
了 该 功能 : 


程序 清单 19.1 使 用 Spring 的 MailSender 发 送 Email 





Email 


地 址 


ailMessage!(); 
R py phe Nt 世 
r{) .getFullName{); 构造 消息 





mailSsender.send (message)}; 发 送 Email 


sendSimpleSpittleEmail() 方 法 所 做 的 第 一 件 事 就 是 构 
造 SimpleMailMessage 实 例 。 正 如 其 名 称 所 示 ， 这 个 对 象 可 以 很 便捷 
地 发 送 Email 消 息 。 


接 下 来 ， 将 设置 消息 的 细节 。 通 过 邮件 消息 的 setFrom() 和 setTo() 方 
法 指定 了 Email 的 发 送 者 和 接收 者 。 在 通过 setSsubJject() 方 法 设置 完 主 
题 后 ， 虚 拟 的 “信封 ”已 经 完成 了 。 剩 下 的 驶 是 调用 setText () 方 法 来 设 
置 消息 的 内 容 。 


和 步 是 将 消息 传递 给 邮件 发 送 器 的 send() 方 法 ， 这 样 邮件 就 发 送 
了 。 








现在 ， 我 们 已 经 配置 好 了 邮件 发 送 器 并 使 用 它 来 发 送 简单 的 Email 消 
息 。 可 以 看 到 ， 使 用 Spring 的 Email 抽象 非常 简单 。 我 们 可 以 到 此 为 止 并 
转 到 下 一 章 ， 但 是 如 果 这 样 的 话 将 会 错过 Spring Email 抽象 中 很 有 意思 
的 内 容 。 让 我 们 更 进一步 ， 看 一 下 如 何 添加 附件 并 创建 丰富 内 容 的 


Email 消息 。 





19.2 ”构建 丰富 内 容 的 Email 消 奶 

对 于 简单 的 事情 来 讲 ， 纯 文本 的 Email 消息 是 比较 合适 的 ， 比 如 邀请 朋 
友 去 观看 比赛 。 但 是 ， 如 果 你 要 发 送 照 片 或 文档 的 话 ， 这 种 方式 就 不 那 
么 理想 了 。 如 果 作 为 市 场 推 广 Email 的 话 ， 它 也 无 法 吸引 接收 者 的 注 
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高 


、 


驻 好 ，Spring 的 Email 功 能 并 不 局 限于 纯 文 本 的 Email。 我 们 可 以 添加 附 
件 ， 甚 至 可 以 使 用 HTML 来 美化 消息 体 的 内 容 。 让 我 们 首先 从 基本 的 添 
加 附件 开始 ， 然 后 更 进一步 ， 借 助 HIML 使 我 们 的 Email 消息 更 加 美 
观 。 


19.2.1 添加 附件 


如 果 发 送 带 有 附件 的 Email， 关 键 技巧 是 创建 multipart 类 型 的 消息 
Email 由 多 个 部 分 组 成 ， 其 中 一 部 分 是 Email 体 ， 其 他 部 分 是 附件 。 


对 于 发 送 附件 这 样 的 需求 来 说 ，SimpleMailMessage 过 于 简单 了 。 为 
了 发 送 multipart 类 型 的 Email， 你 需要 创建 一 个 MIME (Multipurpose 
Internet Mail Extensions) 的 消息 ， 我 们 可 以 从 邮件 发 送 左 的 
createMimeMessage() 方 法 开始 : 


MimeMessage message = mailSender.createMimeMessage(); 


就 这 样 ， 我 们 已 经 有 了 要 使 用 的 MIME 消 息 。 看 起 来 ， 我 们 所 需要 做 的 
就 是 指定 收 件 人 和 发 件 人 地 址 、 主 题 、 一 些 内 容 以 及 一 个 附件 。 尽 管 确 
实 是 这 样 ， 但 并 不 是 你 想 的 那么 简 

单 。javax.mail.internet.MimeMessage 本 身 的 API 有 些 笨重 。 好 消 
息 是 ，Spring 提 供 的 MimeMessageHelper 可 以 帮助 我 们 。 








为 了 使 用 MimeMessageHelper， 我 们 需要 实例 化 它 并 将 MimeMessage 
传 给 其 构造 器 : 


MimeMessageHelper helper = new MimeMessageHelper(message, true); 


构造 方法 的 第 二 个 参数 ， 在 这 里 是 个 布尔 值 true， 表 明 这 个 消 妃 是 





multipart 类 型 的 。 


得 到 了 MimeMessageHelper 实 例 后 ， 我 们 就 可 以 组 装 Email 消 息 了 。 这 
里 最 主要 区 别 在 于 使 用 helper 的 方法 来 指定 Email 细 节 ， 而 不 再 是 设置 消 
轧 对 象 : 


String spitterName = spittle.getSpitter().getFullName(); 
helper.setFrom("noreply@spitter.com"); 
helper .setTo(to); 


helper.setSubject("New spittle from " + spitterName); 
helper.setText(spitterName + " says: " + spittle.getText()); 





在 发 送 Email 之 前 ， 你 唯一 还 要 做 的 就 是 添加 附件 ， 在 本 例 中 ， 也 残 是 
一 张 图 标 图 片 。 为 了 做 到 这 一 点 ， 你 需要 加 载 图 片 并 将 其 作为 资源 ， 然 
后 将 这 个 资源 传递 给 helper 的 addAttachment 方 法 : 


FileSystemResource couponImage = 
new FileSystemResource("/collateral/coupon.png"); 


helper.addAttachment("Coupon.png", couponImage); 





在 这 里 ， 我 们 使 用 Spring 的 FilesystemResource 来 加 载 位 于 应 用 类 路 
径 下 的 coupon.png。 然 后 ， 调 用 addAttachment()。 第 一 个 参数 是 要 添 
加 到 Email 中 附件 的 名 称 ， 第 二 个 参数 是 图 片 资 源 。 


multipart 类 型 的 Email 已 经 构建 完成 了 ， 现 在 可 以 发 送 它 了 。 完 整 的 
sendSpitt1leEmailwithAttachment() 方 法 如 下 所 示 。 


程序 清单 19.2 ”使 用 MimeMessageHelper 发 送 带 有 附件 的 Email 





jeErmai1lWithattachrment( 





ttle spit essagingException { 


构造 
消息 helper 


ailSender.createMimeMessage!(); 


(spitterName + " 
urce onImage = 
ral/coupon.png"); 


; CouponImage); 添加 附件 


multipart 类 型 的 Email 能 够 实现 很 多 的 功能 ， 添 加 附件 只 是 其 中 之 一 。 除 
此 之 外 ， 通 过 将 Email 体 指 明 为 HIML， 我 们 可 以 生成 比 简单 文本 更 漂 

亮 的 Email。 接 下 来 ， 看 一 下 如 何 使 用 MimeMessageHelper 来 发 送 更 吸 
引 人 的 Email。 





19.2.2 ”发 送 宇 文本 内 容 的 Email 


发 送 曙 文 本 的 Email 与 发 送 简 单 文本 的 Email 并 没有 太 大 区 别 。 关 键 苹 将 
消息 的 文本 设置 为 HTML 。 要 做 到 这 一 点 只 需 将 HIML 字 符 串 传递 给 
helper 的 setText() 方 法 ， 并 将 第 二 个 参数 设置 为 true: 





helper.setText("<html><body><img src='cid:spitterLogo'>" + 
"<h4>" + spittle.getSpitter().getFullName() + " says...</h4>" + 


"<i>" + spittle.getText() + "</i>" + 
“</body></html>", true); 





第 二 个 参数 表明 传递 进来 的 第 一 个 参数 是 HTML， 所 以 需要 对 消 姑 的 内 
容 类 型 进行 相应 的 设置 。 


要 注意 的 是 ， 传 递 进 来 的 HTML 包 含 了 一 个 <img> 标 签 ， 用 来 在 Email 中 
展现 Spittr 应 用 程序 的 logo。src 属 性 可 以 设置 为 标准 的 “http:”URL， 
以 便于 从 Web 中 获取 Spittr 的 logo。 但 在 这 里 ， 我 们 将 logo 图 片 钥 入 在 了 
Email 之 中 。 值 “cid:spitterLogo” 表 明 在 消息 中 会 有 一 部 分 是 图 片 并 
以 spitterLogo 来 进行 标识 。 


为 消 恩 深 加 先 入 式 的 图 片 与 添加 附件 很 类 似 。 不 过 这 次 不 再 使 用 helper 
的 addAttachment() 方 法 ， 而 是 要 调用 addInline() 方 法 : 











ClassPathResource :image = 


new ClassPathResource("spitter logo 56.png"”) ; 
helper.addInline("spitterLogo", image); 








addInline 的 第 一 个 参数 表明 内 联 图 片 的 标识 从 一 一 与 <ijmg> 标 签 的 
src 属 性 所 指定 的 相同 。 第 二 个 参数 是 图 片 的 资源 引用 ， 这 里 使 
用 ClassPathResource 从 应 用 程序 的 类 路 径 中 获取 图 片 。 


除了 setText () 方 法 稍微 不 同 以 及 使 用 了 addInline() 方 法 以 外 ， 发 送 
含有 富 文本 内 容 的 Email 与 发 送 带 有 附件 的 普通 文本 消息 很 类 似 。 为 了 
进行 对 比 ， 以 下 是 新 的 sendRichspitterEmail() 方 法 。 








public void sendRichSpitterEmail(String to, Spittle spittle) 
throws MessagingException { 
MimeMessage message = mailSender.createMimeMessage!(); 
MimeMessageHelper helper = new MimeMessageHelper (message, true): 
helper.setFrom("noreply@spitter.com"); 
helper.setTo{"craig@habuma.com"}); 
helper.setSubject ("New spittle from " + 设置 
spittle.getspitter() .getFullName()); HTML 内 容 体 
helper.setText{"<html><body><img src='cid:spitterLogo'>" + 村 
"<h4>" + spittle.getSpitter() .getFullName() + " says...</h4>" + 
“<i>" + spittle.getText{() + “</i>" + 
“</body></html>", true); 
ClassPathResource image = 
new ClassPathResource{(l"spitter_logo_50.png"); 
helper.addInline("spitterLogo", image); 二 一 添加 内 联 图 片 
mailSsender.send(message); 


} 


现在 你 发 送 的 Email 带 有 富 文 本 内 容 和 网 入 式 图 片 了 ! 你 可 以 到 此 为 止 
并 完全 结束 你 的 Email 代码 。 但 创建 Email 体 时 ， 使 用 字符 串 拼 接 的 办 法 
来 构建 HTML 消息 依旧 让 我 觉得 美中不足 。 在 结束 Email 话题 之 前 ， 让 
我 们 看 看 如 何 用 模板 来 代 蔡 字符 串 拼接 消息 。 


19.3 ”使 用 模板 生成 Email 


使 用 字符 串 拼接 来 构建 Email 消息 的 问题 在 于 Email 最 终 会 是 什么 样子 并 
不 清晰 。 在 你 的 大 脑 中 解析 HTML 标 签 并 想象 它 在 泻 染 时 会 是 什么 样子 
是 挺 困 难 的 。 而 将 HTML 混 合 在 Java 代 码 中 又 会 使 得 这 个 问题 更 加 复 

杂 。 如 果 能 够 将 Email 的 布局 抽取 到 一 个 模板 中 ， 而 这 个 模板 可 以 由 美 
术 设计 师 “〈 可 能 是 很 讨厌 Java 代 码 的 人 ) 来 完成 将 会 是 很 棒 的 一 件 事 。 


我 们 需要 与 最 终 HTML 接 近 的 方式 来 表达 Email 布局 ， 然 后 将 模板 转换 

成 String 并 传递 给 helper 的 setText() 方 法 。 在 将 模板 转换 为 String 时 ， 

我 们 有 多 种 模板 方案 可 供 选 择 ， 包 括 Apache Velocity 和 Thymeleaf。 让 我 

J 何 使 用 这 两 种 方案 创建 语文 本 的 Email 消息 ， 允 从 Velocity 开 
台 吧 。 











19.3.1 ”使 用 Velocity 构建 Email 消息 


Apache Velocity 是 由 Apache 提 供 的 通用 模板 引擎 。Velocity 有 挺 长 的 历 
史 了 ， 并 且 已 经 应 用 于 各 种 任务 中 ， 包 括 代 码 生成 以 及 代 蔡 JSP。 它 还 
能 用 于 格式 化 宇文 本 Email 消息 ， 也 就 是 我 们 在 这 里 的 用 法 。 


为 了 使 用 Velocity 对 Email 进行 布局 ， 我 们 需要 将 VelocityEngine 装 配 

到 SpitterEmailServiceImp1 中 。Spring 提 供 了 一 个 名 

为 VelocityEngineFactoryBean 的 工厂 bean， 它 能 够 在 Spring 应 用 上 
下 文中 很 便利 地 生成 VelocityEngine。VelocityEngineFactoryBean 的 
声明 如 下 : 


@Bean 
public VelocityEngineFactoryBean velocityEngine() { 
VelocityEngineFactoryBean velocityEngine = 
new VelocityEngineFactoryBean(); 


Properties props = new Properties(); 


props.setPproperty("resource.1loader", "class"); 
props.setPproperty("class.resource.loader.class", 

ClasspathResourceLoader.class.getName()); 
velocityEngine.setVelocityProperties(props); 
return velocityEngine; 





VelocityEngineFactoryBean 唯 一 要 设置 的 属性 
是 velocityProperties。 在 本 例 中 ， 我 们 将 其 配置 为 从 类 路 径 下 加 载 
Velocity 模板 〈 关 于 配置 Velocity 的 更 多 细节 ， 请 查阅 Velocity 文档 ) 。 


现在 ， 我 们 可 以 将 Velocity 引擎 装配 到 SpitterEmailServiceImp1 中 。 
因为 SpitterEmailServiceImpl 是 使 用 组 件 扫描 实现 自动 注册 的 ， 我 
们 可 以 使 用 @Autowired 来 自动 装配 velocityEngine 属 性 : 


@Autowired 
VelocityEngine velocityEngine; 


现在 ，velocityEngine 属 性 可 用 了 ， 我 们 可 以 使 用 它 将 Velocity 模 板 转 
换 为 String， 并 作为 Email 文 本 进行 发 送 。 为 了 帮助 我 们 完成 这 一 点 ， 
Spring 自 带 了 VelocityEngineUtils 来 简化 将 Velocity 模 板 与 模型 数据 
合并 成 String 的 工作 。 以 下 是 我 们 可 能 的 使 用 方式 : 





Map<String, String> model = new HashMapx<String, String>(); 
model.put("spitterName", spitterName); 


model.put("spittleText", spittle.getText()); 
String emailText = VelocityEngineUtils.mergeTemplateIntoSstring( 
velocityEngine, "emailTemplate.vm", model ); 





为 了 给 处 理 模板 做 准备 ， 我 们 首先 创建 了 一 个 Map 用 来 保存 模板 使 用 的 
模型 数据 。 在 前 面 字符 串 拼 接 的 代码 中 ， 我 们 需要 Spitter 的 全 名 及 其 
Spittle 的 文本 ， 这 里 也 是 一 样 。 为 了 产生 合并 后 的 Email 文本 ， 我 们 只 需 
调用 VelocityEngineUtils 的 mergeTemplateIntoSstring() 方 法 并 将 
Velocity 引擎 、 模 板 路 径 〈 相 对 于 类 路 径 根 ) 以 及 模型 Map 传 递 进去 。 


在 Java 代 码 中 剩 下 的 事情 就 是 得 到 合并 后 的 Email 文 本 ， 并 将 其 传递 给 
helper 的 setText() 方 法 : 


helper.setText(emailText, true); 


模板 位 于 类 路 径 的 根 目 录 下 ， 是 一 个 名 为 emailTemplate.vm 的 文件 ， 它 
看 起 来 可 能 是 这 样 的 : 














<html> 
<body> 
<img src='cid:spitterLogo ' > 


<h4>${spitterName} says...</h4> 
<i>${spittleText}</i> 

</body> 

</html> 


你 可 以 看 到 ， 模 板 文件 比 前 面 的 字符 囊 拼 接 版 本 读 起 来 容易 多 了 。 
此 ， 它 也 更 容易 维护 和 编辑 。 图 19.2 给 出 了 这 种 类 型 Email 的 一 个 示例 。 








New spittle from Craig Walis 


Ap 于 二 > a a 
咖 .| 漠 Eq Eg 5g 
Get Mail Write Address Book Reply ReplyAll Forward Tag Deiete 
Subjsct New spittle from Craig Walls 
From: noreply@spitter.com ™ 
Date: 12:11 AM 


To: craig@habuma.com ™ 


Spijfr 


Craipg Walls says... 





| Hey, here's a test spittle! 


图 19.2 ”Velocity 模 板 和 获 入 的 图 片 能 够 装扮 原本 单调 乏味 的 Email 


在 看 到 图 19.2 的 效果 后 ， 我 觉得 有 很 多 地 方 可 以 对 模板 进行 优化 从 而 使 
得 Email 看 起 来 更 漂 宫 。 但 是 ， 我 将 它 作 为 给 读者 的 练习 。 


Velocity 作 为 模板 引擎 已 经 存在 好 多 年 了 ， 并 且 适 用 于 很 多 种 任务 。 但 
是 ， 如 第 6 章 所 示 ， 一 种 新 的 模板 方案 正在 变 得 日 益 流 行 。 接 下 来 ， 我 
们 看 一 下 如 何 使 用 Thymeleaf 来 构建 Spittle Email 消 息 。 














19.3.2 ”使 用 Thymeleaf 构 建 Email 消 息 


如 我 们 第 6 章 所 讨论 的 那样 ，Thymeleaf 是 一 种 很 有 吸引 力 的 HTML 模板 
引擎 ， 因 为 它 能 够 创建 WYSIWYG 的 模板 。 与 JSP 和 Velocity 不 同 ， 

Thymeleaf 模 板 不 包含 任何 特殊 的 标签 库 和 特有 的 标签 。 这 样 模板 设计 
师 在 工作 的 时 候 ， 能 够 使 用 任意 他 们 所 喜欢 的 HIML 工 具 ， 而 不 必 担 心 





某 个 工具 无 法 处 理 特定 的 标签 。 


当 我 们 将 Email 模板 转换 为 Thymeleaf 模 板 时 ，Thymeleaf 的 WYSIWYG 特 
性 体现 得 非常 明显 : 


< IlDOCTYPE html> 


<html xmlns:th="http://www.thymeleaf.org"> 
<body> 
<img src="spitterLogo.png" th:src='cid:spitterLogo'> 


<h4><span th:text="${spitterName}">Craig Walls</span> says...</h4> 
<i><span th:text="${spittleText}">Hello there!</span></i> 

</body> 

</html> 





注意 ， 这 里 没有 任何 自 定 义 的 标签 (在 JSP 中 可 能 会 见 到 这 种 情况 〉。 
尽管 模型 属性 是 通过 “${f}2? 标 记 的 ， 但 是 它们 仅 用 于 属性 的 值 中 ， 不 会 
像 Velocity 那样 用 在 外 边 。 这 种 模板 可 以 很 容易 地 在 Web 浏 览 器 中 打 
开 ， 并 且 以 完整 的 形式 进行 展现 ， 不 必 依赖 于 Thymeleaf 引 擎 的 处 理 。 


使 用 Thymeleaf 来 生成 和 发 送 Email 消 息 的 做 法 非常 类 似 于 Velocity: 


Context ctx = new Context(); 

ctx.setVariable("spitterName", spitterName); 
ctx.setVariable("spittleText", spittle.getText()); 

String emailText = thymeleaf.process("emailTemplate.html", ctx); 


helper.setText(emailText, true); 
mailSender.send(message); 








这 里 做 的 第 一 件 事情 就 是 创建 Thymeleaf Context 实 例 ， 并 将 模型 数据 
填充 进去 。 这 与 我 们 使 用 Velocity 的 时 候 ， 将 模型 数据 填充 到 Map 中 很 类 
似 。 然 后 ， 我 们 要 求 Thymeleaf 处 理 模 板 ， 通 过 调用 Thymeleaf 引 擎 的 
process() 方 法 ， 将 上 下 文中 的 模型 数据 合并 到 模板 中 。 最 后 ， 我 们 将 
结果 形成 的 文本 借助 消息 helper 设 置 到 Email 消 轧 中 ， 并 使 用 邮件 发 送 器 
将 消息 发 送出 去 。 


这 看 起 来 很 简单 。 但 是 Thymeleaf 引 擎 〈 也 区 是 thymeleaf 变 量 ) 是 从 
哪里 来 的 呢 ? 


这 里 的 Thymeleaf 引 擎 与 我 们 在 第 6 章 构 建 Web 视 图 时 所 使 用 的 





SpringTemplateEnginebean 是 相同 的 。 在 这 里 ， 我 们 使 用 构造 器 注入 
的 方式 将 其 注入 到 SpitterEmailServiceImp1 中 : 


@Autowired 
private SpringTemplateEngine thymeleaf; 


@Autowired 

public SpitterEmailServiceImpl(SpringTemplateEngine thymeleaf) { 
this.thymeleaf = thymeleaf; 

} 





不 过 ， 我 们 必要 要 对 SpringTemplateEnginebean 做 一 点 小 修改 。 在 第 
6 草 中 ， 它 配置 为 从 Servlet 上 下 文中 解析 模板 ， 而 我 们 的 Email 模板 需要 
从 类 路 径 中 解析 。 所 以 ， 除 了 ServletContextTemplateResolver,， 
还 需要 一 个 ClassLoaderTemplateResolver: 


@Bean 

public ClassLoaderTemplateResolver emailTemplateResolver() { 
ClassLoaderTemplateResolver resolver = 

new ClassLoaderTemplateResolver(); 

resolver.setprefix("mail/"); 
resolver.setTemplateMode("HTML5"); 
resolver.setCharacterEncoding("UTF-8"); 
setOrder(1); 
return resolver; 





就 大 部 分 而 言 ， 配 置 ClassLoaderTemplateResolver bean 的 方式 类 似 
于 ServletContextTemplateResolver。 不 过 ， 需 要 注意 ， 我 们 

将 prefix 属 性 设置 为 “mai/*， 这 表明 它 会 在 类 路 人 径 根 的 “mail* 目 录 下 开 
始 查 找 Thymeleaf 模 板 。 因 此 ，Email 模 板 文件 的 名 字 必 须 是 
emailTemplate.html， 并 且 位 于 类 路 径 根 的 “mail” 目 录 下 。 


因为 我 们 现在 有 两 个 模板 解析 器 ， 所 以 需要 使 用 order 属 性 表明 优先 使 用 
哪 一 个 。ClassLoaderTemplateResolver 的 order 属 性 为 1， 因 此 我 们 
修改 一 下 ServletContext-TemplateResolver， 将 其 order 属 性 设置 为 
2: 





@Bean 
public ServletContextTemplateResolver webTemplateResolver() { 
ServletContextTemplateResolver resolver = 


new ServletContextTemplateResolver(); 
resolver.setprefix("/WEB-INF/templates/"); 
resolver.setTemplateMode("HTML5"); 
resolver.setCharacterEncoding("UTF-8"); 
setOrder(2); 
return resolver; 





现在 ， 剩 下 的 任务 就 是 修改 SpringTemp1lateEnginebean 的 配置 ， 让 它 
使 用 这 两 个 模板 解析 器 : 


@Bean 
public SpringTemplateEngine templateEngine( 
Set<ITemplateResolver> resolvers) { 


SpringTemplateEngine engine = new SpringTemplateEngine(); 
engine.setTemplateResolvers(resolvers); 
return engine; 


} 





在 此 之 前 ， 我 们 只 有 一 个 模板 解析 器 ， 所 以 可 以 将 其 注入 

到 springTemplateEngine 的 templateResolver 属 性 中 。 但 现在 我 们 
有 了 两 个 模板 解析 器 ， 所 以 必须 将 它们 作为 Set 的 成 员 ， 然 后 将 这 

个 Set 注入 到 templateResolvers (复数 ) 属性 中 。 


19.4 ”小结 


Email 是 人 与 人 之 间 通 信 的 重要 形式 ， 通 常 也 是 应 用 与 人 进行 通信 的 一 
种 形式 。Spring 基 于 Java 所 提供 的 Email 功能 ， 抽 象 了 JavaMail， 使 得 在 
Spring 中 使 用 和 配置 起 来 都 更 加 简单 。 


在 本 章 中 ， 我 们 看 到 了 如 何 使 用 Spring 的 Email 抽象 功能 发 送 简单 的 
Email 消息 ， 然 后 更 进一步 ， 学 习 了 如 何 发 送 包含 附件 和 经 过 HTML 格 
式 化 的 宇文 本 消息 。 我 们 还 看 到 了 如 何 使 用 像 Velocity 和 Thymeleaf 这 样 
的 模板 引擎 生成 语文 本 Email 文本 ， 避 免 了 通过 字符 串 拼 接 创建 
HIML 。 


在 下 一 章 中 ， 我 们 将 会 学 习 如 何 借 助 Java 管 理 扩展 〈Java Management 
Extensions，JMX) 为 Spring bean 添 加 管理 和 通知 功能 。 


第 20 章 ”使 用 JMX 管 理 Spring Bean 


本 章 内 容 : 


。 将 Spring bean 录 露 为 MBean 
。 远程 管理 Spring Bean 
。 处 理 JMX 通 知 


Spring 对 DI 的 支持 是 通过 在 应 用 中 配置 bean 属 性 ， 这 是 一 种 非常 不 错 的 

方法 。 不 过 ， 一 旦 应 用 已 经 部 萌 并 且 正 在 运行 ， 单独 使 用 DI 并 不 能 帮助 
我 们 改变 应 用 的 配置 。 假 设 我 们 希望 深入 了 解 正在 运行 的 应 用 并 要 在 运 
行 时 改变 应 用 的 配置 ， 此 时 ， 束 可 以 使 用 Java 管 理 扩展 〈Java Manage- 

ment Extensions，JMX) 了 。 


JMX 这 项 技术 能 够 让 我 们 管理 、 监 视 和 配置 应 用 。 这 项 技术 最 初 作 为 
Java 的 独立 扩展 ， 从 Java 5 开始 ，JMX 己 经 成 为 标准 的 组 件 。 


使 用 JMX 管 理应 用 的 核心 组 件 是 托管 beaan (managed bean, MBean) 。 
所 谓 的 MBean 束 是 暴露 特定 方法 的 JavaBean， 这 些 方法 定义 了 管理 接 
口 。JMX 规 范 定义 了 如 下 4 种 类 型 的 MBean: 


。 标准 MBean: 标准 MBean 的 管理 接口 是 通过 在 固定 的 接口 上 执行 反 
射 确定 的 ，bean 类 会 实现 这 个 接口 ; 

动态 MBean: 动态 MBean 的 管理 接口 是 在 运行 时 通过 调 

用 DynamicMBean 接 口 的 方法 来 确定 的 。 因 为 管理 接口 不 是 通过 青 

态 接 口 定义 的 ， 因 此 可 以 在 运行 时 改变 ; 

开放 MBean: 开放 MBean 是 一 种 特殊 的 动态 MBean， 其 属性 和 方法 
只 限定 于 原始 类 型 、 原 始 类 型 的 包 涛 类 以 及 可 以 分 解 为 原始 类 型 或 
原始 类 型 包装 类 的 任意 类 型 ; 

模型 MBean: 模型 MBean 也 是 一 种 特殊 的 动态 MBean， 用 于 充当 管 
理 接 口 与 受 管 资源 的 中 介 。 模 型 Bean 并 不 像 它 们 所 声明 的 那样 来 编 
写 。 它 们 通常 通过 工厂 生成 ， 工 厂 会 使 用 元 信息 来 组 装 管 理 接口 。 


Spring 的 JMX 模 块 可 以 让 我 们 将 Spring bean 导 出 为 模型 MBean， 这 样 我 
们 束 可 以 但 看 应 用 程序 的 内 部 情况 并 且 能 够 更 改 配 置 一 一 甚至 在 应 用 的 





























运行 期 。 搂 下 来 ， 将 会 介绍 如 何 使 用 Spring 对 JMX 的 支持 来 管理 Spri 
应 用 上 下 文中 的 bean。 Ei 


20.1 将 Spring bean 导 出 为 MBean 


这 里 有 几 种 方式 可 以 让 我 们 通过 使 用 JMX 来 管理 Spittr 应 用 中 的 bean。 为 
了 让 事情 尽量 保持 简单 ， 我 们 对 程序 清单 5.10 中 SpittleController 只 
做 适度 的 改变 ， 增 加 一 个 新 的 spittlesPerPage 属 性 : 


public static final int DEFAULT_ SPITTLES PER PAGE = 25; 
private int spittlesPerPage = DEFAULT_SPITTLES_PER_PAGE ; 


public void setSpittlesPerPage(int spittlesPerPage) { 
this.spittlesPerPage = SpittlesPerPage; 


} 


public int getSpittlesperpage() { 
return spittlesPerPpage; 


} 





之 前 ， 当 我 们 调用 spitterService 的 getRecentSpittles() 方 法 

时 ，SpittleController 传 入 20 作 为 第 二 个 参数 ， 0 

条 Spittle。 现 在 ， 不 再 古 在 构建 应 用 时 通过 便 编 码 进行 决策 是 通 
过 使 用 JMX 在 运行 时 进行 决 集 。 新 增 的 spittlesperpPage 属 性 只 只 是 是 第 
二 而 六 5 


但 是 spittlesPerPage 属 性 本 号 并 不 能 实现 通过 外 部 配置 来 改变 页 面 
上 所 显示 Spittle 的 数量 。 它 只 是 bean 的 一 个 属性 ， 跟 bean 的 其 他 属性 一 
样 。 我 们 下 一 步 需要 做 的 是 把 SpittleControllerbean 暴 露 为 MBean， 
而 spittlePerpage 属 性 将 成 为 MBean 的 托管 属性 (managed 
attribute 》。 这 时 ， 我 们 就 可 以 在 运行 时 改变 该 属性 的 值 。 


Spring 的 MBeanExporter 是 将 Spring Bean 转 变 为 MBean 的 关 

键 。MBeanExporter 可 以 把 一 个 或 多 个 Spring bean 导 出 为 MBean 服 务 器 
(MBean server) 内 的 模型 MBean。MBean 服 务 器 (有 了 时候 也 被 称 为 
MBean 代 理 ) 是 MBean 生 存 的 容器 。 对 MBean 的 访问 ， 也 是 通过 MBean 
服务 器 来 实现 的 。 


如 图 20.1 所 示 ， 将 Spring bean 导 出 为 JMX MBean 之 后 ， 可 以 使 用 基于 
JMX 的 管理 工具 (例如 JConsole 或 者 VisualVM) 查看 正在 运行 的 应 用 程 
序 ， 显 示 bean 的 属性 并 调用 bean 的 方法 。 





Spring 应 用 上 下 文 


MBean 
服务 器 


JConsole 























图 20.1 Spring 的 MBeanExporter 可 以 将 Spring bean 的 属性 和 方法 导出 为 MBean 服 务 器 中 的 JMX 属 
性 和 操作 。 通 过 JMX 服 务 器 ，JMX 管 理工 具 《〈 例 如 JConsole) 可 以 查看 到 正在 运行 的 应 用 程序 
的 内 部 情况 




















下 面 的 @Bean 方 法 在 Spring 中 声明 了 一 个 MBeanExporter， 它 会 
将 spittleControllerbean 导 出 为 一 个 模型 MBean: 


@Bean 

public MBeanExporter mbeanExporter(SpittleController spittleController) { 
MBeanExporter exporter = new MBeanExporter(); 
Map<String, Object> beans = new HashMap<String, Object>(); 


beans.put("spitter:name=SpittleController", spittleController); 
exporter .setBeans(beans ) ; 
return exporter 





配置 MBeanExporter 的 最 简单 方式 是 为 它 的 peans 属 性 配置 一 个 Map 集 
合 ， 该 集合 中 的 元 素 是 我 们 希望 暴露 为 JMX MBean 的 一 个 或 多 个 bean。 
每 个 Map 条 目的 key 就 是 MBean 的 名 称 《〈 由 管理 域 的 名 字 和 一 个 key- 
value 对 组 成 ， 在 SpittleController MBean 示 例 中 

是 spitter:name=HomeController) ， 而 Map 条 目的 值 则 是 需要 暴露 
的 Spring bean 引 用 。 在 这 里 ， 0 以 
便 它 的 属性 可 以 通过 JMX 在 运行 时 进行 管理 


通过 MBeanExporter.， spittleControllerbean 将 作为 模型 MBean 以 
SpittleController 的 名 称 导出 到 MBean 服 务 器 中 ， 以 实现 管理 功 





能 。 图 20.2 展 示 了 通过 JConsole 查 看 SpittleControllerMBean 时 的 情 
7 见 。 
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图 20.2 ”SpittleController 导 出 为 MBean， 并 且 可 以 通过 JConsole 查 看 


如 图 20.2 的 左 侧 所 示 ， SpittleController 所 有 的 public 成 员 都 被 导出 

为 MBean 的 操作 或 属性 。 这 可 能 并 不 是 我 们 所 希望 看 到 的 结果 ， 我 们 真 
正 需 要 的 只 是 可 以 配置 spittlesPerPage 属 性 。 我 们 不 需要 调 

用 spittles() 方 法 或 spittleController 中 的 其 他 方法 或 属性 。 

此 ， 我 们 需要 一 个 方式 来 科 选 所 需要 的 属性 或 方法 。 


了 ,0 的 属性 和 操作 获得 更 细 粒 度 的 控制 ，Spring 提 供 了 几 种 选 
举 》 后 


。 通过 名 称 来 声明 需要 其 露 或 忽略 的 bean 方 法 ; 
。 衣 过 为 bean 增 加 接口 来 选择 要 其 露 的 方法 ; 
。 通过 注解 标注 bean 来 标识 托管 的 属性 和 操作 。 








我 们 会 答 试 每 一 种 方式 来 决定 哪 一 种 最 适 
合 SpittleControllerMBean。 我 们 首先 通过 名 称 来 选择 bean 的 哪些 方 
法 需要 辽 露 。 


MBean 服 务 器 从 何 处 而 来 


根据 以 上 配置 ，MBeanExporter 会 假设 它 正 在 一 个 应 用 服务 器 中 例如 
Tomcat) 或 提供 MBean 服 务 器 的 其 他 上 下 文中 运行 。 但 是 ， 如 果 Spring 
应 用 程序 是 独立 的 应 用 或 运行 的 容器 没有 提供 MBean 服 务 器 ， 我 们 就 需 
要 在 Spring 上 下 文中 配置 一 个 MBean 服 务 占 。 


在 XML 配置 中 ，<context :mbean-server> 元 素 可 以 为 我 们 实现 该 功 
能 。 如 果 使 用 Java 配 置 的 话 ， 我 们 需要 更 直接 的 方式 ， 也 就 是 配置 类 型 
为 MBeanServerFactoryBean 的 bean 〈 这 也 是 在 XML 中 
<context:mbean-server> 元 素 所 作 的 事情 ) 。 








MBeanServerFactoryBean 会 创建 一 个 MBean 服 务 器 ， 并 将 其 作为 
Spring 应 用 上 下 文中 的 bean。 默 认 情 况 下 ， 这 个 bean 的 ID 是 
mbeanServer。 了 解 到 这 一 点 ， 我 们 就 可 以 将 它 装 配 到 MBeanExporter 
的 server 属 性 中 用 来 指定 MBean 要 暴露 到 哪个 MBean 服务 器 中 。 





20.1.1 通过 名 称 暴 露 方法 


MBean 信 息 装 配器 (MBean info assembler) 是 限制 哪些 方法 和 属性 将 在 
MBean 上 暴露 的 关键 。 其 中 有 一 个 MBean 信 息 装 配器 

是 MethodNameBasedMBean-InfoAssembler。 这 个 装配 器 指定 了 需要 
暴露 为 MBean 操 作 的 方法 名 称 列表 。 对 于 SpittleController bean 来 
说 ， 我 们 希望 把 spittlePerPage 暴 露 为 托管 属性 。 基 于 方法 名 的 装配 
器 如 何 帮 我 们 导出 一 个 托管 属性 呢 ? 


我 们 回顾 下 JavaBean 的 规则 《这 不 是 Spring Bean 押 必需 

的 ) ，spittlesPerPage 属 性 需要 定义 对 应 的 存 取 器 (accessor) 方 
法 ， 方 法 名 必须 为 setSpittlesPerPage() 和 
getSpittlesPerPage()。 为 了 限制 MBean 所 暴露 的 内 容 ， 我 们 需要 告 
诉 MethodNameBaseMBeanInfoAssembler 仅 在 MBean 的 接口 中 包含 这 
两 个 方法 。 如 下 MethodNameBaseMBeanInfoAssembler 的 bean 声 明 就 
配置 了 这 些 方法 : 








@Bean 
public MethodNameBasedMBeanInfoAssembler assembler() { 
MethodNameBasedMBeanInfoAssembler assembler = 
new MethodNameBasedMBeanInfoAssembler(); 


assembler.setManagedMethods(new String[] { 
"getSpittlesPerPage", "setSpittlesPerpage" 

}); 

return assembler; 


} 





managedMethods 属 性 可 以 接受 一 个 方法 名 称 的 列表 ， 指 定 了 哪些 方法 
将 暴露 为 MBean 的 操作 。 因 为 本 示例 所 配置 的 是 spittlesPerPage 属 性 
的 存 取 器 方法 ， 所 以 spittlesPerPage 属 性 也 自然 成 为 了 MBean 的 托管 
属性 。 


为 了 让 这 个 装配 嚣 能够 生效 ， 我 们 需要 将 它 装 配 进 MBeanExporter 中 : 


@Bean 
public MBeanExporter mbeanExporter( 
SpittleController spittleController, 
MBeanInfoAssembler assembler) { 
MBeanExporter exporter = new MBeanExporter(); 


Map<String, Object> beans = new HashMap<String, Object>(); 
beans.put("spitter:name=SpittleController", spittleController); 
exporter .setBeans(beans ) ; 

exporter.setAssembler(assembler); 

return exporter; 





现在 如 果 我 们 启动 应 用 ，SpittleController 的 spittlesPerPage 将 
作为 有 效 的 MBean 托 管 属性 ， 而 spittles() 方 法 并 不 会 暴露 为 MBean 
的 托管 操作 。 图 20.3 展 示 了 通过 JConsole 查 看 SpittleController 的 情况 。 


是 MethodExclusionMBeanInfoAssembler。 这 个 MBean 信 息 装 配器 
是 MethodNameBaseMBeanInfoAssembler 的 反 操作 。 它 不 是 指定 哪些 
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图 20.3” 当 指定 了 哪些 方法 在 SpittleController MBean 上 暴露 后 ， 
spittles() 方 法 不 再 作为 MBean 的 托管 操作 


另 一 个 基于 方法 名 称 的 装配 器 





方法 需要 暴露 为 MBean 的 托管 操 
作 ， MethodExclusionMBeanInfoAssembler 指 定 了 不 需要 


MBean 托 管 操 作 的 方法 名 称 


的 方法 : 





@Bean 

public MethodExclusionMBeanInfoAssembler assembler() { 
MethodExclusionMBeanInfoAssembler assembler = 

new MethodExclusionMBeanInfoAssembler(); 

assembler.setIgnoredMethods(new String[] { 

"spittles" 


}); 











水 列 表 。 例 如 ， 在 这 里 我 们 使 
用 MethodExclusionMBeanInfoAssemb1le 指 定 spittles() 作 为 不 暴露 


Peturn assembler:; 
} 


基于 方法 名 称 的 装配 器 是 最 直接 和 易于 使 用 的 。 但 是 如 果 需 要 把 多 个 
Spring bean 导 出 为 MBean， 我 们 能 想象 将 出 现 什 么 样 的 情形 吗 ? 为 装配 
器 所 配置 的 方法 名 称 清单 将 会 变 得 非常 庞大 ;而 且 还 有 一 种 可 能 ， 我 们 
希望 暴露 一 个 bean 的 某 个 方法 ， 但 不 希望 暴露 另 一 个 bean 的 同名 方法 。 


很 明显 ， 在 Spring 配置 方面 ， 当 导出 多 个 MBean 时 ， 基 于 方法 名 称 的 方 
式 并 不 能 很 好 地 满足 此 场景 。 让 我 们 看 一 下 如 果 使 用 接口 暴露 MBean 的 
操作 和 属性 是 否 更 为 合适 。 


20.1.2 ”使 用 接口 定义 MBean 的 操作 和 属性 


en 种 MBean 信 息 装 
配器 ， 可 以 让 我 们 通过 使 用 接口 来 选择 bean 的 哪些 方法 需要 姑 露 为 
MBean 的 托管 操作 。InterfaceBasedMBeanInfoAssembler 与 基于 方 
法 名 称 的 装配 器 很 相似 ， 只 不 过 不 再 通过 罗列 方法 名 称 来 确定 骏 露 哪些 
方法 ， 而 是 通过 列 出 接口 来 声明 哪些 方法 需要 暴露 。 


例如 ， 假 设 我 们 定义 了 一 个 名 
为 SpittleControllerManagedOperations 的 接口 ， 如 下 所 示 : 
































package com.habuma.spittr.jmx; 


public interface SpittleControllerManagedOperations { 
int getSpittlesPerPage(); 
void setSpittlesperpage(int spittlesPerPage) ; 





在 这 里 ， 我 们 选择 了 setspittlesPerPage() 方 法 和 
getSpittlesPerPage() 方 法 作为 需要 暴露 的 方法 。 再 次 提醒 ， 这 一 对 
存 取 器 方法 间接 暴露 了 spittlesPerPage 属 性 作为 MBean 的 托管 属性 。 
为 了 应 用 此 装配 器 ， 我 们 只 需要 使 用 如 下 的 assemblerbean 蔡 换 之 前 基 
于 方法 名 称 的 装配 器 即 可 : 








@Bean 
public InterfaceBasedMBeanInfoAssembler assembler() { 
InterfaceBasedMBeanInfoAssembler assembler = 


new InterfaceBasedMBeanInfoAssembler(); 
assembler.setManagedInterfaces( 
new Class<?>[] { SpittleControllerManagedOperations.class } 


); 
} 


了 
Peturn assembler.; 





managedInterfaces 属 性 接受 一 个 或 多 个 接口 组 成 的 列表 作为 MBean 
的 管理 接口 一 一 在 本 示例 中 
为 SpittleControllerManagedOperations 接 口 。 


SpittleController 并 没有 显 式 实现 
SpittleControllerManagedOperations 接 口 ， 这 可 能 并 不 明显 ， 但 
相当 有 趣 。 这 个 接口 只 是 为 了 标识 导出 的 内 容 ， 但 我 们 并 不 需要 在 代码 
中 直接 实现 该 接口 。 不 过 ，SpittleController 应 该 实现 这 个 接口 ， 
2 
办 议 。 


如 果 通 过 接口 来 选择 MBean 操 作 的 话 ， 最 吸引 人 的 一 点 在 于 我 们 可 以 把 
很 多 方法 放 在 少量 的 接口 中 ， 从 而 确保 
InterfaceBasedMBeanInfoAssembler 的 配置 尽量 简洁 。 在 输出 多 个 
MBean 时 ， 基 于 接口 的 方式 可 以 帮助 保持 Spring 配置 的 简洁 。 


最 终 ， 这 些 托管 操作 必须 在 某 处 声明 ， 无 论 是 在 Spring 配置 中 还 是 在 某 
个 接口 中 。 此 外 ， 从 代码 角度 看 ， 托 管 操作 的 声明 是 一 种 重复 一 一 在 接 
口中 或 Spring 上 下 文中 声明 的 方法 名 称 与 实现 中 所 声明 的 方法 名 称 存 在 
重复 。 之 所 以 存在 这 种 重复 ， 没 有 其 他 原因 ， 仅 仅 是 为 了 满足 
MBeanExporter 的 需要 而 产生 的 。 


Java 注 解 的 一 项 工作 就 是 帮助 消除 这 种 重复 。 让 我 们 看 看 如 何 通 过 使 用 
注解 标注 Spring 管理 的 bean， 从 而 将 其 导出 MBean。 






































20.1.3 ”使 用 注解 驱动 的 MBean 


除了 我 同 你 展示 的 MBean 信 息 装 配器 ，Spring 还 提供 了 另 一 种 装配 丹 

Metadata-MBeanInfoAssembler， 这 种 装配 器 可 以 使 用 注解 标识 
哪些 bean 的 方法 需要 暴露 为 MBean 的 托管 操作 和 属性 。 我 完全 可 以 同 你 
展示 如 何 使 用 这 种 装配 器 ， 但 我 不 会 这 么 做 。 这 是 因为 手工 装配 它 非常 
繁杂 ， 仪 仪 是 为 了 使 用 注解 并 不 值得 这 么 做 。 相 反 ， 我 将 回 你 展示 如 何 











使 用 Spring context 配 置 命 名 空间 中 的 <context :mbean-export> 元 
素 。 这 个 便捷 的 元 素 装 配 了 MBean 导 出 器 以 及 为 了 在 Spring 局 用 注解 驱 
动 的 MBean 所 需要 的 装配 器 。 我 们 所 需要 做 的 束 是 使 用 它 来 蔡 换 我 们 之 
前 所 使 用 的 MBeanExporterbean: 


<context:mbean-export server="mbeanServer" /> 


现在 ， 要 把 任意 一 个 Spring bean 转 变 为 MBean， 我 们 所 需要 做 的 仅仅 是 
使 用 @ManagedResource 注 解 标注 bean 并 使 用 @ManagedOperation 
或 @ManagedAttribute 注 解 标 注 bean 的 方法 。 例 如 ， 如 下 的 程序 清单 
展示 了 如 何 使 用 注解 把 spittleController 导 出 为 MBean。 


程序 清单 20.1 通过 注解 把 HomeController 转 变 为 MBean 


将 
SpittleController 
导出 为 MBean 








this.spittiesPerPage spittlesPer e 将 spittlesPerPage 
} | | 暴露 为 托管 属性 





在 类 级 别 使 用 了 @ManagedResource 注 解 来 标识 这 个 bean 应 该 被 导出 为 
MBean。objectName 属 性 标识 了 域 (Spitter) 和 MBean 的 名 称 
(SpittleController) 。 


spittlesPerPage 属 性 的 存 取 器 方法 都 使 用 了 @ManagedAttribute 注 
解 来 进行 标注 ， 这 表示 该 属性 应 该 暴露 为 MBean 的 托管 属性 。 注 意 ， 其 
实 并 不 需要 使 用 注解 同时 标注 这 两 个 存 取 器 方法 。 如 果 我 们 选择 仅 标 注 
setSpittlesPerPage() 方 法 ， 那 我 们 仍 可 以 通过 JMX 设 置 该 属性 ， 但 
这 样 的 话 我 们 将 不 能 碍 看 该 属性 的 值 。 相 反 ， 如 果 仅 仅 标注 
getSpittlesPerPage() 方 法 ， 那 我 们 可 以 通过 JMX 碍 看 该 属性 的 值 ， 








但 无 法 修改 该 属性 的 值 。 


同样 需要 提醒 一 下 ， 我 们 还 可 以 使 用 QManagedoperation 注 解 蔡 
换 @ManagedAttribute 注 解 来 标注 存 取 嚣 方法。 如 下 所 示 : 





@ManagedOperation 
public void setSpittlesperpage(int spittlesPerPage) { 
this.spittlesPerPage = spittlesPerPage; 


} 


@ManagedOperation 
public int getSpittlesperpage() { 
return spittlesPerPpage; 


} 








这 会 将 方法 骏 露 为 MBean 的 托管 操作 ， 但 是 并 不 会 把 spittlesPerPage 
属性 暴露 为 MBean 的 托管 属性 。 这 是 因为 在 暴露 MBean 功 能 时 ， 使 

用 @Managedoperation 注 解 标 注 方法 是 严格 限制 方法 的 ， 并 不 会 把 它 
作为 JavaBean 的 存 取 器 方法 。 因 此 ， 使 用 @ManagedOperation 可 以 用 来 
把 bean 的 方法 暴露 为 MBean 托 管 操 作 ， 而 使 用 @ManagedAttribute 可 以 
把 bean 的 属性 暴露 为 MBean 托 管 属性 。 





20.1.4 ”处 理 MBean 冲 突 


到 目前 为 止 ， 我们 已 经 看 到 可 以 使 用 多 种 方式 在 MBean 服 务 器 中 注册 
MBean。 在 所 有 的 示例 中 ， 我 们 为 MBean 指 定 的 对 象 名 称 是 由 管理 域名 
和 key-value 对 组 成 的 。 如 果 MBean 服 务 器 中 不 存在 与 我 们 MBean 名 字 相 
同 的 已 注册 的 MBean， 那 我 们 的 MBean 注 册 时 就 不 会 有 任何 问题 。 但 是 
如 果 名 字 冲 突 时 ， 将 会 发 生 什 么 呢 ? 


默认 情况 下 ，MBeanExporter 将 抛 出 
InstanceAlreadyExistsException 异 常 ， 该 异常 表明 MBean 服 务 器 
中 已 经 存在 相同 名 字 的 MBean。 不 过 ， 我 们 可 以 通过 MBeanExporter 的 
registrationBehaviorName 属 性 或 者 <context :mbean-export> 的 


registration 属 性 指定 冲突 处 理 机 制 来 改变 默认 行为 。 


Spring 提 供 了 3 种 借助 registrationBehaviorName 属 性 来 处 理 MBean 
名 字 冲 突 的 机 制 : 











。 FAIL_ON_EXISTING: 如 果 已 存在 相同 名 字 的 MBean， 则 失败 〈 默 
认 行 为 ) ; 

。 IGNORE_EXISTING: 忽略 冲突 ， 同 时 也 不 注册 新 的 MBean; 

。 REPLACING_EXISTING: 用 新 的 MBean 获 盖 已 存在 的 MBean; 


例如 ， 如 果 我 们 使 用 MBeanExporter， 我 们 可 以 通过 设 
置 registration-BehaviorName 属 性 
为 RegistrationPolicy.IGNORE_ EXISTING 来 忽略 冲突 ， 如 下 所 示 : 


@Bean 
public MBeanExporter mbeanExporter( 
SpittleController spittleController, 
MBeanInfoAssembler assembler) { 
MBeanExporter exporter = new MBeanExporter(); 
Map<String, Object> beans = new HashMap<String, Object>(); 


beans.put("spitter:name=SpittleController", spittleController); 
exporter .setBeans(beans ) ; 

exporter.setAssembler(assembler); 
exporter.setRegistrationpolicy(Registrationpolicy.IGNORE EXISTING); 
return exporter; 





registrationBehaviorName 属 性 可 以 接受 RegistrationPolicy 中 所 
定义 的 枚 举 值 ， 每 一 个 取 值 分 别 对 应 3 种 冲突 处 理 机 制 的 一 种 。 


现在 我 们 已 使 用 MBeanExporter 注 册 了 我 们 的 MBean， 我 们 还 需要 一 种 
方式 来 访问 它们 并 进行 管理 。 正 如 之 前 所 看 到 的 ， 我 们 可 以 使 用 诸如 
JConsole 之 类 的 工具 来 访问 本 地 的 MBean 服 务 器 ， 进 而 显示 和 操纵 
MBean， 但 是 像 JConsole 之 类 的 工具 并 不 适合 在 程序 中 对 MBean 进 行 管 
理 。 我 们 如 何在 一 个 应 用 中 操纵 另 一 个 应 用 中 的 MBean 昵 ? 竺 运 的 是 ， 
还 存在 另 一 种 方式 可 以 把 MBean 作 为 远程 对 象 进行 访问 。 让 我 们 进一步 
研究 Spring 对 远程 MBean 的 文 持 ， 了 解 如 何 通 过 远程 接口 以 标准 的 方式 
来 访问 MBean。 








20.2 ”远程 MBean 


虽然 最 初 的 JMX 规 范 提 及 了 通过 MBean 进 行 应 用 的 远程 管理 ， 但 是 它 并 
没有 定义 实际 的 远程 访问 协议 或 API。 因 此 ， 会 由 JMX 供 应 商定 义 自己 
的 JMX 远 程 访问 解决 方案 ， 但 这 通常 又 是 专 有 的 。 


为 了 满足 以 标准 方式 进行 远程 访问 JMX 的 需求 ，JCP (Java Community 

Process) 制订 了 JSR-160: Java 管 理 扩展 远程 访问 API 规 范 (Java 

Management Extensions Remote API Specification ) 。 该 规范 定义 了 JMX 

远程 访问 的 标准 ， 该 标准 至 少 需要 绑 定 RMI 和 可 选 的 JMX 消 息 协 议 
(CJMX Messaging Protocol , JMXMP) 。 


在 本 小 节 中 ， 我 们 将 看 到 Spring 如 何 远 程 访 问 MBean。 我 们 首先 从 配置 
Spring 把 SpittleController 导 出 为 远程 MBean 开 始 ， 然 后 我 们 再 了 解 
如 何 使 用 Spring 远程 操纵 MBean。 














20.2.1 ”又 露 远程 MBean 
使 MBean 成 为 远程 对 象 的 最 简单 方式 是 配置 Spring 的 


ConnectorServer-FactoryBean: 


@Bean 
public ConnectorServerFactoryBean connectorServerFactoryBean() { 


return new ConnectorServerFactoryBean(); 


} 





ConnectorServerFactoryBean 会 创建 和 启动 JSR-166 
JMXConnectorServer。 默 认 情 况 下 ， 服 务 器 使 用 JMXMP 协 议 并 监听 
端口 9875 一 一 因此 ， 它 将 绑 

定 “service:jmx:jmxmp://localhost:9875”。 但 是 我 们 导出 MBean 
的 可 选 方案 并 不 局 限于 JMXMP。 


根据 不 同 JMX 的 实现 ， 我 们 有 多 种 远程 访问 协议 可 供 选 择 ， 包 括 远程 方 
法 调用 (Remote Method Invocation，RMI) 、SOAP、Hessian/Burlap 和 
IOP (Internet InterORB Protocol) 。 为 MBean 绑 定 不 同 的 远程 访问 协 

议 ， 我 们 仅 需 要 设置 ConnectorServerFactoryBean 的 serviceUr1l 属 


性 。 例 如 ， 如 果 我 们 想 使 用 RMI 远 程 访问 MBean， 我 们 可 以 像 下 面 示例 








这 样 配置 : 


@Bean 
public ConnectorServerFactoryBean connectorServerFactoryBean() { 
ConnectorServerFactoryBean csfb = new ConnectorServerFactoryBean(); 


csfb.setServiceUrl( 
"service:jmx:rmi://localhost/jndi/rmi://localhost:10699/spitter"); 
return csfb; 


} 





在 这 里 ， 我 们 将 ConnectorServerFactoryBean 绑 定 到 了 一 个 RMI 注 册 
表 ， 该 注册 表 监 听 本 机 的 1099 端 口 。 这 意味 着 我 们 需要 一 个 RMI 注 册 表 
运行 时 ， 并 监听 该 端口 。 我 们 可 以 回顾 下 第 15 

章 ，RmiServiceExporter 可 以 为 我 们 上 自动 启动 一 个 RMI 注 册 表 。 但 
是 ， 我 们 在 本 示例 中 不 使 用 RmiserviceExporter， 而 是 通过 在 Spring 
中 声明 RmiRegistryFactoryBean 来 启动 一 个 RMI 注 册 表 ， 如 下 面 的 
@Bean 方 法 所 示 : 


@Bean 
public RmiRegistryFactoryBean rmiRegistryFB() { 
RmiRegistryFactoryBean rmiRegistryFB = new RmiRegistryFactoryBean(); 


PmiRegistryFB.setPort(1699 ) ; 
return rmiRegistryFB; 


} 








没 错 ! 现在 我 们 的 MBean 可 以 通过 RMI 进 行 远程 访问 了 。 但 是 如 果 没 有 
人 通过 RMI 访 问 MBean 的 话 ， 那 就 不 值得 这 么 做 。 所 以 现在 让 我 们 把 关 
注 点 转 同 JMX 远 程 访 问 的 客户 端 ， 看 看 如 何在 Spring 中 装配 一 个 远程 
MBean 到 JMX 客 户 端 中 。 


和 


20.2.2 ”访问 远程 MBean 


要 想 访 问 远 程 MBean 服 务 器 ， 我 们 需要 在 Spring 上 下 文中 配 

置 MbeanServer-ConnectionFactoryBean。 下 面 的 bean 声 明 装 配 了 一 
个 MbeanServerConnection-FactoryBean， 该 bean 用 于 访问 我 们 在 上 
一 节 中 所 创建 的 基于 RMI 的 远程 服务 器 。 





@Bean 
public MBeanServerConnectionFactoryBean connectionFactoryBean() { 
MBeanServerConnectionFactoryBean mbscfb = 


new MBeanServerConnectionFactoryBean(); 
mbscfb.setServiceUrl( 
"service:jmx:rmi://localhost/jndi/rmi://localhost:10699/spitter"); 
return mbscfb; 


} 





顾名思义 ，MBeanServerConnectionFactoryBean 是 一 个 可 用 于 创建 
MbeanServer-Connection 的 工厂 bean。 

由 MBeanServerConnectionFactoryBean 所 生成 的 
MBeanServerConnection 实 际 上 是 作为 远程 MBean 服 务 器 的 本 地 代 
理 。 它 能 够 以 MBeanServerConnection 的 形式 注入 到 其 他 bean 的 属性 
中 : 


@Bean 

public JmxClient jmxClient(MBeanServerConnection connection) { 
JmxClient jmxClient = new JmxClient(); 
jmxClient.setMbeanServerConnection(connection); 
return jmxClient; 


} 





MBeanServerConnection 提 供 了 多 种 方法 ， 我 们 可 以 使 用 这 些 方法 查 
询 远 程 MBean 服 务 器 并 调用 MBean 服 务 右 内 所 注册 的 MBean 的 方法 。 例 
如 ， 如 果 我 们 希望 知道 在 远程 MBean 服 务 器 中 有 多 少 已 注册 的 MBean， 

可 以 用 如 下 的 代码 片段 打印 这 些 信息 : 


int mbeanCount = mbeanServerConnection.getMBeanCount(); 





System.out.println("There are " + mbeanCount + " MBeans"); 


我 们 还 可 以 使 用 queryNames() 方 法 查询 远程 服务 器 中 所 有 MBean 的 名 
称 : 


java.util.Set mbeanNames = mbeanServerConnection.queryNames(null, null); 


传递 给 queryNames() 方 法 的 两 个 参数 用 于 过 滤 查 询 结 果 。 如 果 将 两 个 
参数 都 设置 为 nul1， 输 出 结果 为 所 有 已 注册 的 MBean 的 名 称 。 


查询 远程 MBean 服 务 器 上 bean 的 数量 和 名 称 虽 然 很 有 趣 ， 不 过 并 不 能 完 
成 更 多 的 工作 。 远 程 访 问 MBean 服 务 器 的 真正 价值 在 于 访问 远程 服务 嘎 
上 已 注册 MBean 的 属性 以 及 调用 它们 的 方法 。 


为 了 访问 MBean 属 性 ， 我 们 可 以 使 用 getAttribute() 和 
setAttribute() 方 法 。 例 如 ， 为 了 获取 MBean 属 性 的 值 ， 我 们 可 以 按 
照 下 面 的 方法 调用 getAttribute( ) 方 法 : 


String cronExpression = mbeanServerConnection.getAttribute( 


new ObjectName("spitter:name=SpittleController"), "spittlesperpage"); 





同样 ， 我 们 可 以 使 用 setAttribute() 方 法 改变 MBean 属 性 的 值 : 


mbeanServerConnection.setAttribute( 
new ObjectName("spitter:name=SpittleController"), 
new Attribute("spittlesPerPage"，16)); 





如 果 和 希望 调用 MBean 的 操作 ， 那 我 们 需要 使 用 invoke() 方 法 。 下 面 的 
内 容 描 述 了 如 何 调用 spittleController MBean 的 
setSpittlesPerPage() 方 法 : 


mbeanServerConnection.invoke( 
new ObjectName("spitter:name=SpittleController"), 
"SetSpittlesPerPage"， 


new Object[] { 166 }, 
new String[] {"int"}); 





我 们 还 可 以 使 用 MBeanServerConnection 的 方法 对 远程 MBean 做 很 多 
其 他 的 事情 。 我 把 它 作 为 一 个 任务 留 给 你 。 不 过 ， 通 过 
MBeanServerConnection 对 远程 MBean 进 行 方法 调用 和 属性 设置 是 一 
种 很 笨拙 的 方法 。 要 想 调 用 setSpittlesPerPage() 这 样 一 个 简单 的 方 
法 ， 我 们 需要 创建 一 个 ObjectName 实 例 ， 并 向 invoke() 方 法 传递 几 个 
参数 。 它 并 不 是 直观 的 方法 调用 。 为 了 更 直接 地 调用 方法 ， 我 们 需要 代 
理 远 程 MBean。 


20.2.3 ”代理 MBean 


Spring 的 MBeanProxyFactoryBean 是 一 个 代理 工厂 bean， 像 我 们 在 第 15 
间 中 所 演示 的 远程 代理 工厂 bean 类 似 。 在 前 面 所 介绍 的 内 容 中 ， 它 们 会 
提供 代理 ， 用 来 访问 远程 的 Spring 受 管 bean， 与 之 不 

同 ，MBcanProxyFactoryBean 可 以 让 我 们 可 以 直接 访问 远程 的 

《就 如 同 配置 在 本 地 的 其 他 bean 一 样 ) 。 图 20.4 展 示 了 它 的 工作 
原理 。 
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图 20.4 MBeanFactoryBean 创 建 远程 MBean 的 代理 。 客 户 端 通过 此 代理 与 远程 MBean 进 行 交 


互 ， 就 像 它 是 本 地 Bean 一 样 
































例如 ， 考 虑 如 下 的 MBeanProxyFactoryBean 声 明 : 


@Bean 
public MBeanProxyFactoryBean remoteSpittleControllerMBean( 
MBeanServerConnection mbeanServerClient) { 
MBeanProxyFactoryBean proxy = new MBeanpProxyFactoryBean(); 


proxy.setOobjectName(""); 

proxy.setServer(mbeanServerClient); 
proxy.setPproxyInterface(SpittleControllerManagedOperations.class); 
return proxy; 





objectName 属 性 指定 了 远程 MBean 的 对 象 名 称 。 在 这 里 是 引用 我 们 之 
前 导出 的 SpittleControllerMBean。 


server 属 性 引用 了 MBeanServerConnection， 通 过 它 实现 MBean 所 有 
通信 的 路 由 。 在 这 里 ， 我 们 注入 了 之 前 配置 的 


MBeanServerConnectionFactoryBean。 


最 后 ，proxyInterface 属 性 指定 了 代理 需要 实现 的 接口 。 在 本 示例 
中 ， 我 们 使 用 20.1.2 小 节 所 定义 的 
SpittleControllerManaged0Operations 接 口 。 


对 于 上 面 声 明 的 remoteSpittleControllerMBean， 我 们 现在 可 以 把 
它 注入 到 类 型 为 SpittleControllerManagedOperations 的 bean 属 性 
中 ， 并 使 用 它 来 访问 远程 的 MBean。 这 样 ， 我 们 就 可 以 调 

用 setSpittlesPerPage() 和 和 getSpittlesPerPage() 方 法 了 。 


我 们 已 经 看 到 与 MBean 通 信 的 几 种 方式 ， 现 在 我 们 可 以 在 应 用 运行 的 时 
候 显 示 和 调整 Spring bean 配 置 。 但 是 目前 为 止 ， 这 都 是 单方 面 的 会 话 。 
都 是 我 们 与 MBean 在 沟通 。 现 在 是 时 候 通 过 监听 通知 Cnotification ) 来 
倾听 它们 在 说 什么 。 


20.3 ”处 理 通知 


通过 查询 MBean 获 得 信息 只 是 查看 应 用 状态 的 一 种 方法 。 但 当 应 用 发 生 
重要 事件 时 ， 如 果 和 希望 能 够 及 时 告知 我 们 ， 这 通常 不 是 最 有 效 的 方法 。 
例如 ， 假 设 Spittr 永 用 保存 了 已 发 布 的 Spittle 数 量 ， 而 我 们 希望 知道 每 发 
布 一 百 万 Spittle 时 的 精确 时 间 〈 例 如 一 百 万 、 两 百 万 、 三 百 万 等 ) 。 一 
种 解决 方法 是 编写 代码 定期 查询 数据 库 ， 计 算 Spittle 的 数量 。 但 是 执行 
0 因为 它 需 要 不 断 的 检查 Spittle 的 
量 。 
与 重复 查询 数据 库 获得 Spittle 的 数量 相 比 ， 更 好 的 方式 是 当 这 类 事件 发 
生 时 让 MBean 通 知 我 们 。JMX 通 知 (JMX notification， 如 图 20.5 所 示 ) 
是 MBean 与 外 部 世界 主动 通信 的 一 种 方法 ， 而 不 是 等 待 外 部 应 用 对 
MBean 进 行 查询 以 获得 信息 。 
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图 20.5 JMX 通 知 使 MBean 与 外 部 世界 进行 主动 通信 
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Spring 通过 NotificationPub1isherAware 接 口 提供 了 发 送 通知 的 支 
持 。 任 何 希望 发 送 通知 的 MBean 都 必须 实现 这 个 接口 。 例 如 ， 请 查看 如 
下 程序 清单 中 的 SpittleNotifierImpl。 


程序 清单 20.2 ”使 用 NotificationPublisher 来 发 送 JMX 通 知 


package com.habuma.spittr.jmx; 

import javax.management .Notification; 

import org.springframework.jmx.export.annotation.ManagedNotification; 

import org.springframework. jmx.export.annotation.ManagedResource; 

import 

Org.springframework.jmx.export.notification.NotificationPublisher:; 

import 

org.springframework.jmx.export.notification.NotificationPublisherAware; 
import org.springframework.stereotype.Component; 

@Component 实现 
ManagedResource! SEE er:name=SpitterNotifier") NotificationPublisherAware 接口 
ManagedNotification!( 

notif 有 生生 全 SR 
name= "TODO") 

public class SpittleNotifierImpl 








implements NotificationPublisherAware, SpittleNotifier { 
private NotificationPublisher notificationPublisher; 注入 
public void setNotificationPublisher ( =— notificationPublisher 
NotificationPublisher notificationPublisher) { 


this.notificationPublisher = notificationPpublisher; 
} 
public void millionthSpittlePosted() { 
notificationPublisher.sendNotification! 4 发 送 通知 
new Notification( 
"SpittleNotifier.OneMillionspittles", this, 0)); 


正如 我 们 所 看 到 的 ，Spitt1leNotifierImp1 实 现 了 
NotificationPublisherAware 接 口 。 这 并 不 是 一 个 要 求 苛刻 的 接 
口 ， 它 仅 要 求实 现 一 个 方法 : setNotificationPub1lisher。 


SpittleNotificationImp1 也 实现 了 Spitt1leNotifier 接 口 的 方 

法 : millionthSspittlePosted()。 这 个 方法 使 用 了 

eh maa 
NotificationPublisher 来 发 送 通 知 : 我 们 的 Spittle 数 量 又 到 了 一 个 新 
的 百 万 级 别 。 


一 旦 sendNotification() 方 法 被 调用 ， 就 会 发 出 通知 。 嗯 .……. 好 像 我 
们 还 没 决定 谁 来 接收 这 个 通知 。 那 就 让 我 们 建立 一 个 通知 监听 器 来 监听 
和 处 理 通知 。 

20.3.1 监听 通知 


接收 MBean 通 知 的 标准 方法 是 实现 
javax.management .NotificationListener 接 口 。 例 如 ， 考 虑 一 


下 PagingNotificationListener: 


package com.habuma.spittr.jmx; 

import javax.management.Notification; 

import javax.management .NotificationListener; 

public class PagingNotificationListener 
ijmplements NotificationListener { 


public void handleNotification( 
Notification notification, Object handback) { 





PagingNotificationListener 是 一 个 典型 的 JMX 通 知 监听 器 。 当 接 

收 到 通知 时 ， 将 会 调用 handleNotification() 方 法 处 理 通知 。 大 概 的 

逻辑 可 能 是 ，PagingNotification-Listener 的 

handleNotification() 方 法 将 同 寻 呼 机 或 手机 上 发 送 消 恩 来 告知 

I 
) 。 


剩 下 的 工作 只 需要 使 用 MBeanExporter 注 册 
PagingNotificationListener: 








@Bean 
public MBeanExporter mbeanExporter() { 
MBeanExporter exporter = new MBeanExporter(); 
Map<?, NotificationListener> mappings = 
new HashMap<?, NotificationListener>(); 


mappings.put("Spitter:name=PpagingNotificationListener", 

new PagingNotificationListener()); 
exporter.setNotificationListenerMappings(mappings); 
return exporter; 





MBeanExporter 的 notificationListenerMappings 属 性 用 于 在 监听 
器 和 监听 器 所 希望 监听 的 MBean 之 间 建 立 映 射 。 在 本 示例 中 ， 我 们 建立 
了 PagingNotificationListener 来 监听 由 SpittleNotifier MBean 所 发 
布 的 通知 。 


20.4 ”小 结 


JMX 是 对 应 用 程序 进行 操纵 的 一 而 窗口 。 在 本 章 ， 我 们 了 解 了 如 何 配置 
Spring 上 自动 地 把 Spring bean 导 出 为 JMX MBean， 从 而 可 以 让 我 们 通过 
JMX 管 理工 具 碍 看 和 操作 bean 的 信息 。 我 们 也 了 解 了 当 MBean 和 工具 彼 
此 距离 很 远 时 ， 如 何 创建 和 使 用 远程 MBean。 最 后 ， 我 们 还 了 解 了 如 何 
使 用 Spring 发 布 和 监听 JMX 通 知 。 


人 :或 许 注 意 到 这 本 书 剩 余 的 页 数 越 来 越 少 ， 0 
结束 。 但 是 在 这 之 前 ， 我 们 沿途 还 会 经 停 一 站 。 在 下 一 章 ， 我 们 将 会 看 

i Boot， 这 是 开发 Spring 应 用 的 一 种 新 方法 ， 借 助 这 种 令 人 汲 

动 的 新 方法 我 们 可 以 只 保留 很 少 的 显 式 配置 ， 甚 至 可 能 完全 没有 配置 。 














第 21 章 ”借助 Spring Boot 简 化 
Spring 开 肥 


本 章 内 容 : 


。 使 用 Spring Boot Starteri 专 加 项 目 依 赖 
。 上 自动 化 的 bean 配置 

。 Groovy 与 Spring Boot CLI 

e Spring Boot Actuator 


在 我 刚 开始 学 习 微 积分 谍 程 的 时 候 ， 我 们 学 习 了 函数 的 导数 。 当 时 我 们 
使 用 非常 复杂 的 极限 来 计算 函数 的 导数 。 即 便 函 数 非常 简单 ， 计 算 导 数 
相关 的 工作 依然 像 吐 梦 一 样 。 


在 布置 完 作业 、 建 立 完 学 习 小 组 并 考 完 试 后 ， 班 上 的 大 多 数 同学 都 能 够 
完成 这 项 任务 了 。 但 是 它 的 单调 无 趣 依然 让 我 们 无 法 忍受 。 如 果 “ 微 积 
分 (上 ) ”的 课程 束 这 样 的 话 ， 那 在 “ 微 积分 《下 ) ”中 ， 又 该 有 怎样 恐 
怖 的 数学 计算 在 等 着 我 们 呢 ? 


然后 ， 老 师 给 我 们 开 了 一 个 玩笑 。 通 过 使 用 一 个 简单 的 公式 就 能 快速 将 
导数 计算 出 来 《如果 你 学 习 过 微 积 分 的 话 ， 你 应 该 能 够 明日 我 说 的 古 什 
么 ) 。 通 过 这 种 新 技巧 ， 在 以 前 计算 一 个 函数 导数 的 时 间 内 ， 我 们 能 够 
计算 出 十 多 个 函数 的 导数 。 


此 时 ， 一 位 同学 向 老师 提出 了 一 个 问题 ， 这 也 古 我 们 每 位 同学 所 想 
的 : “您 为 什么 不 在 第 一 天 就 教会 我 们 这 个 公式 呢 ? 1 ” 


老师 这 样 解释 ， 比 较 困 难 的 那 种 方法 能 够 帮助 我 们 理解 导数 的 含义 、 告 
诉 我 们 它 的 特性 ， 并 说 这 种 方式 对 我 们 有 这 样 那样 的 好 处 。 


现在 ， 我 们 用 整 本 书 的 篇 幅 介 绍 了 Spring， 我 发 现 自己 处 在 类 似 于 微 积 
分 老师 那样 的 位 置 。 尽 管 Spring 带 来 的 主要 益处 就 是 简化 Java 开 发 ， 但 
本 章 将 会 介绍 Spring Boot 如 何 让 这 项 任务 变 得 更 加 简单 。 从 Spring 创建 
以 来 ，Spring Boot 大 概 是 Spring 领域 中 最 令 人 兴奋 的 事情 了 。 它 在 Spring 














区 
的 内 
我 们 首先 整体 上 了 解 一 下 Spring Boot， 看 它 是 如 何 简化 Spring 的 。 在 本 
章 结 束 之 前 ， 我 们 将 会 使 用 Spring Boot 构 建 一 个 完整 的 (尽管 比较 简 
单 ) 应 用 程序 。 


， 构 建 了 全 新 的 开发 模型 ， 移 除了 开发 Spring 应 用 中 很 多 单调 乏味 


21.1 Spring Boot 人 简介 


在 Spring 家 族 中 ，Spring Boot 是 令 人 兴 否 “〈 也 许 我 敢 说 它 是 改变 游戏 规 
则 的 ) 的 新 项 目 。 它 提供 了 四 个 主要 的 特性 ， 能 够 改变 开发 Spring 应 用 
程序 的 方式 : 


。 Spring Boot Starter: 它 将 常用 的 依赖 分 组 进行 了 整合 ， 将 其 合并 到 
一 个 依赖 中 ， 这 样 就 可 以 一 次 性 添加 到 项 目的 Maven 或 Gradle 构 建 


中 

。 目 动 配置 : Spring Boot 的 目 动 配置 特性 利用 了 Spring 4 对 条 件 化 配 
置 的 文 持 ， 合 理 地 推测 应 用 所 需 的 bean 并 自动 化 配置 它们 ; 

。 命令 行 接口 〈Comrmand-line interface，CLI) : Spring Boot 的 CLI 发 
挥 了 Groovy 编 程 语言 的 优势 ， 并 结合 自动 配置 进一步 简化 Spring 应 
用 的 开发 ; 

。 Actuator: 它 为 Spring Boot 应 用 添加 了 一 定 的 管理 特性 。 


在 本 章 中 ， 我 们 将 会 使 用 Spring Boot 的 所 有 特性 构建 一 个 小 型 的 应 用 程 
序 。 但 首先 ， 我 们 快速 了 解 一 下 每 项 特性 ， 更 好 地 体验 它们 如 何 简 化 
Spring 编程 模型 。 














21.1.1 添加 Starter 依 赖 


有 两 种 烤 制 重 糙 的 方式 ， 有 热情 的 人 会 将 面粉 、 鸡 重 、 糖 、 发 酵 粉 、 
盐 、 奶 油 、 香 草 调料 以 及 牛奶 混合 在 一 起 ， 和 成 糊 状 。 或 者 也 可 以 购买 
预先 打包 好 的 香 糕 ， 它 包含 了 所 希 的 大 部 分 原料 ， 我 们 只 需 谎 加 一 些 含 
水 分 的 材料 即 可 ， 如 水 、 鸡 和 蛋 和 植物 油 。 


预先 打包 好 的 和 蛋糕 将 制作 蛋糕 过 程 中 所 需 的 各 种 材料 集合 在 了 一 起 ， 作 
为 一 项 材料 来 使 用 ， 与 之 类 似 ，Spring Boot Starter 将 应 用 所 需 的 各 种 依 
赖 聚合 成 一 项 依赖 。 

为 了 阐述 该 功能 ， 假 设 我 们 要 从 头 开 始 编写 一 个 新 的 Spring 应 用 。 这 是 
一 个 Web 项目 ， 所 以 需要 使 用 Spring MVC。 同 时 ， 还 要 有 REST API 将 

资源 暴露 为 JSJON， 所 以 在 构建 中 需要 包含 Jackson JSON 库 。 


因为 应 用 再 要 使 用 JDBC 从 关系 型 数据 库 中 存储 和 得 询 数据 ， 因 此 我 们 


希望 确保 包含 了 Spring 的 JDBC 模 块 〈 为 了 使 用 JdbcTemp1late) 和 
Spring 的 事务 模块 〈 为 了 使 用 声明 式 事务 的 文 持 ) 。 对 于 数据 库 本 里 ， 
H2 数 据 库 是 个 不 错 的 选择 。 


对 了 ， 我 们 还 需要 使 用 Thymeleaf 来 建立 Spring MVC 视 图 。 


如 果 使 用 Gradle 构 建 项 目的 话 ， 在 build.gradle 中 (至 少 ) 需要 包含 如 下 
的 依赖 : 


dependencies { 
compile("org.springframework:spring-web:4.0.6.RELEASE") 
compile("org.springframework:spring-webmvc:4.0.6.RELEASE") 
compile("com.fasterxml.jackson.core:jackson-databind:2.2.2") 


compile("org.springframework:spring-jdbc:4.06.6.RELEASE") 
compile("org.springframework:spring-tx:4.08.6.RELEASE") 
compile("com.h2database:h2:1.3.174") 
compile("org.thymeleaf:thymeleaf-spring4:2.1.2.RELEASE") 





幸好 ，Gradle 能 够 非常 简洁 地 表达 依赖 。 (为 简单 起 见 ， 我 不 再 展现 这 
个 依赖 列表 在 Maven 的 pom.xml 文 件 是 什么 样子 了 。) 即便 如 此 ， 创 建 
这 个 文件 还 是 罕 扯 到 许多 的 事情 ， 而 对 它 的 维护 则 会 更 加 有 兵 烦 。 这 些 依 
赖 之 间 是 如 何 协作 的 呢 ?” 妆 应 用 程序 不 断 地 成 长 和 演进 ， 依 赖 管理 将 会 
变 得 更 加 有 具有 挑战 性 。 


但 是 ， 如 果 我 们 使 用 Spring Boot Starer 所 提供 的 预 打包 依赖 的 话 ， 那 么 
Gradle 依 赖 列表 能 够 更 加 人 简短 一 些 : 





dependencies { 
compile("org.springframework.boot:spring-boot-starter-web: 
1.1.4.RELEASE") 
compile("org.springframework.boot:spring-boot-starter-jdbc: 


1.1.4.RELEASE") 
compile("com.h2database:h2:1.3.174") 
compile("org.thymeleaf:thymeleaf-spring4:2.1.2.RELEASE") 





可 以 看 到 ，Spring Boot 的 Web 和 JDBC Starter 取 代 了 几 个 更 加 细 粒 度 的 依 
赖 。 我 们 依然 还 需要 包含 H2 和 Thymeleaf 的 依赖 ， 不 过 其 他 的 依赖 都 已 
经 放 到 了 Starter 中 。 除 了 依赖 列表 更 加 简短 ， 我 们 可 以 相信 由 Starter 所 
提供 的 依赖 版 本 能 够 互相 兼容 。 


Spring Boot 提 供 了 多 个 Starter，Web 和 JDBC 只 是 其 中 的 两 个 。 表 21.1 列 
出 了 我 在 编写 本 章 时 ， 所 有 可 用 的 Starter。 


表 21.1 Spring Boot Starter 依 赖 将 所 需 的 常见 依赖 按 组 聚集 在 一 起 ， 形 成 单条 依赖 




















Starter 所 提供 的 依赖 


spring-boot- 
starter- spring-boot-starter 、spring-boot-actuator 、spring-core 
actuator 


spring-boot- 


starter-amqp spring-boot-starter 、spring-boot-rabbit 、spring-core 、 spring-tx 


spring-boot- |spring-boot-starter 、spring-aop 、Aspect] Runtime 、AspectJ Weaver 
starter-aop 、 spring-core 


spring-boot- |spring-boot-starter 、HSQLDB 、spring-jdbc 、spring-batch-core 
starter-batch | 、spring-core 


spring-boot- 
starter- 
elasticsearch 


spring-boot-starter、 spring-data-elasticsearch、 spring-core、 
spring-tx 


spring-boot- 
starter- 
gemfire 


spring-boot-starter、 Gemfire、 spring-core、 spring-tx、 spring- 
context、 spring-context-support、 spring-data-gemfire 


spring-boot- |spring-boot-starter、 spring-boot-starter-jdbc、 spring-boot-starter- 
starter-data- |aop、 spring-core、 Hibernate EntityManager、 spring-orm、 spring- 
Jpa data-jpa、 spring-aspects 


spring-boot- 
starter-data- 
mongodb 


spring-boot-starter、 MongoDB Java 驱动 、 spring-core、 spring-tx、 
spring-data-mongodb 


spring-boot- spring-boot-starter、 spring-boot-starter-web、 Jackson 注解 、 


starter-data- ye 外 Rk cz 
FGSE Jackson 数据 绑 定 、 spring-core、 spring-tx、 spring-data-rest-webmvc 





spring-boot- 
starter-data- 
solr 


spring-boot- 
starter- 
freemarker 


spring-boot- 
starter- 
groovy-templ1- 
ates 


spring-boot- 
starter- 
hornetq 


spring-boot- 
starter- 
integration 


spring-boot- 
starter-jdbc 


spring-boot- 
starter-jetty 


spring-boot- 
starter-log4j 


spring-boot- 
starter - 
logging 


spring-boot- 
starter- 
mobile 


spring-boot- 
starter-redis 


spring-boot-starter、 Solrj、 
solr、 Apache HTTP Mime 


spring-core、 spring-tx、 spring-data- 


spring-boot-starter、 spring-boot-starter-web、 Freemarker、 


spring-context-support 


spring- 
core、 


spring-boot-starter、 spring-boot-starter-web、 Groovy、 Groovy 模 
板 、 spring-core 


spring-boot-starter、 spring-core、 spring-jms、 Hornet JMS Client 


spring-boot-starter、 spring-aop、 
webmvc、 spring-integration-core、 
integration-http、 


spring-tx、 spring-web、 
spring-integration-file、 spring- 
spring-integration-stream 


spring- 


spring-integration-ip、 


spring-boot-starter、 spring-jdbc 、tomcat-jdbc、 spring-tx 


jetty-webapp、 jetty-jsp 


jcl-over-slf4j、 jul-to-slf4j 、slf4j-log4j12、1log4j 


jcl-over-slf4j、 jul-to-slf4j 、1log4j-over-slf4j、 logback-classic 


spring-boot-starter、 spring-boot-starter-web、 spring-mobile-device 


spring-boot-starter、 spring-data-redis、 lettuce 





spring-boot- 
starter- 
remote-shell |spring-boot-starter-actuator、 spring-context、 org.crashub.** 


spring-boot- |spring-boot-starter、 spring-security-config、 spring-security-web、 
starter- spring-aop、 spring-beans、 spring-context、 spring-core、 spring- 
security expression、 spring-web 


ee spring-boot-starter、 spring-boot-starter-web、 spring-core、 Spring- 


social- social-config、 spring-social-core、 spring-social-web、 spring- 
facebook social-facebook 


ee spring-boot-starter、 spring-boot-starter-web、 spring-core、 spring- 


social- social-config、 spring-social-core、 spring-social-web、 spring- 
twitter social-twitter 


spring-boot- 
starter- 
social- 
linkedin 


spring-boot-starter、 spring-boot-starter-web、 spring-core、 spring- 
social-config、 spring-social-core、 spring-social-web、 spring- 
social-linkedin 


spring-boot- 


Ea spring-boot、 spring-boot-autoconfigure、 spring-boot-starter-logging 


spring-boot- |spring-boot-starter-logging、 spring-boot、 junit、mockito-core、 
starter-test |hamcrest-library、 spring-test 


spring-boot- 
starter- 
thymeleaf 


spring-boot-starter、 spring-boot-starter-web、 spring-core、 
thymeleaf-spring4、 thymeleaf-layout-dialect 


spring-boot- 
starter- tomcat-embed-core、 tomcat-embed-logging-juli 
tomcat 


spring-boot- |spring-boot-starter、 spring-boot-starter-tomcat、 jackson-databind、 
starter-web |spring-web、 spring-webmvc 





spring-boot- 


starter- spring-boot-starter-web、 spring-websocket、 tomcat-embed-core、 
websocket tomcat-embed-logging-juli 


spring-boot- |spring-boot-starter、 spring-boot-starter-web、 spring-core、 spring- 
starter-ws jms、 spring-oxm、 spring-ws-core、 spring-ws-support 





如 果 碍 看 这 些 Starter 依 赖 的 内 部 原理 ， 你 会 发 现 Starter 的 工作 方式 也 没 
有 什么 神秘 之 处 。 它 使 用 了 Maven 和 Gradle 的 依赖 传递 方案 ，Starter 在 自 
己 的 pom.xml 文 件 中 声明 了 多 个 依赖 。 当 我 们 将 某 一 个 Starter 依 赖 添加 
到 Maven 或 Gradle 构 建 中 的 时 候 ，Starter 的 依赖 将 会 自动 地 传递 性 解析 。 
这 些 依赖 本 身 可 能 也 会 有 其 他 的 依赖 。 一 个 Starter 可 能 会 传递 性 地 引入 
几 十 个 依赖 。 


需要 注意 ， 很 多 Starter 引 用 了 其 他 的 Starter。 例 如 ，mobile Starter 束 引用 
了 Web Starter， 而 后 者 又 引用 了 Tomcat Starter。 大 多 数 的 Starter 都 会 引 
用 spring-boot-starter， 它 实际 上 是 一 个 基础 的 Starter( 当然， 它 也 
依赖 了 logging Starter) 。 依 赖 是 传递 性 的 ， 将 mobile Starter 添 加 为 依赖 
之 后 ， 就 相当 于 添加 了 它 下 面 的 所 有 Starter。 


21.1.2 ”自动 配置 


Spring Boot 的 Starter 减 少 了 构建 中 依赖 列表 的 长 度 ， 而 Spring Boot 的 目 
动 配置 功能 则 削减 了 Spring 配置 的 数量 。 它 在 实现 时 ， 会 考虑 应 用 中 的 
其 他 因素 并 推 朵 你 所 需要 的 Spring 配置 。 


作为 样 例 ， 让 我 们 重新 回忆 第 6 章 〈 程 序 清 单 6.4) ， 要 将 Thymeleaf 模 板 
作为 Spring MVC 的 视图 ， 至 少 需要 三 个 

bean: ThymeleafViewResolver、SpringTemplateEngine 和 和 
TemplateResolver。 但 是 ， 使 用 Spring Boot 自 动 配置 的 话 ， 我 们 需要 
做 的 仪 仅 是 将 Thymeleaf 添 加 到 项 目的 类 路 径 中 。 如 果 Spring Boot 探 测 到 
Thymeleaf 位 于 类 路 径 中 ， 它 就 会 推 新 我 们 需要 使 用 Thymeleaf 实 现 
Spring MVC 的 视图 功能 ， 并 自动 配置 这 些 bean。 


Spring Boot Starter 也 会 触发 自动 配置 。 例 如 ， 在 Spring Boot 应 用 中 ， 如 
果 我 们 想 要 使 用 Spring MVC 的 话 ， 所 需要 做 的 仅仅 是 将 Web Starter 作 为 
依赖 放 到 构建 之 中 。 将 Web Starter 作 为 依赖 放 到 构建 中 以 后 ， 它 会 自动 


























添加 Spring MVC 依 赖 。 如 果 Spring Boot 的 Web 自 动 配置 探测 到 Spring 
MVC 位 于 类 路 径 下 ， 它 将 会 自动 配置 支持 Spring MVC 的 多 个 bean， 包 
括 视 图 解析 器 、 资 源 处 理 占 以 及 消 恩 转换 器 (等 等 ) 。 我 们 接 下 来 需要 
做 的 就 是 编写 处 理 请 求 的 控制 器 。 

21.1.3 Spring Boot CLI 

Spring Boot CLI 充 分 利用 了 Spring Boot Starter 和 自动 配置 的 魔力 ， 并 添 
加 了 一 些 Groovy 的 功能 。 它 简化 了 Spring 的 开发 流程 ， 通 过 CLI， 我 们 
能 够 运行 一 个 或 多 个 Groovy 脚 本 ， 并 得 看 它 是 如 何 运行 的 。 在 应 用 的 运 
行 过 程 中 ，CLI 能 够 自动 导入 Spring 类 型 并 解析 依赖 。 


用 来 前 述 Spring Boot CLI 的 最 有 趣 的 例子 就 是 如 下 的 Groovy 脚 本 : 


@RestController 
class Hi { 
@RequestMapping("/") 


String hi() { 
"Hil! 1 
} 
} 


不 管 你 是 人 否 相信 ， 这 是 一 个 完整 的 《尽管 比较 简单 ) Spring 应 用 ， 它 可 
以 在 Spring Boot CLI 中 运行 。 包括 空格 ， 它 的 长 度 只 有 82 个 字符 。 你 可 
以 将 其 粘贴 到 Twitter 客户 端 ， 并 分 享 给 你 的 朋友 们 。 


去 挥 不 必要 的 空格 ， 我 们 能 够 得 到 只 有 64 个 字符 的 一 行 代码 : 








@RestController class Hi{@RequestMapping("/")String hi(){"Hi!"}} 


这 个 版 本 更 加 简单 ， 在 一 条 Twitter 的 推 文中 ， 我 们 可 以 粘贴 两 次 。 但 它 
依然 是 一 个 完整 可 运行 的 (尽管 特性 比较 简陋 〉Spring 应 用 。 如 果 你 已 
经 安装 过 Spring Boot CLI， 我 们 可 以 使 用 如 下 的 命令 行 来 运行 它 : 


$ spring run Hi.groovy 


以 推 文 的 形式 来 展示 Spring Boot CLI 的 功能 是 很 有 意思 的 ， 但 是 它 所 能 
做 的 事情 并 不 仅 限 于 我 们 所 看 到 的 这 些 。 在 21.3 小 节 中 ， 我 们 将 会 看 到 
如 何 使 用 Groovy 和 CLI 构 建 更 加 完整 的 应 用 。 


21.1.4 Actuator 


Spring Boot Actuator 为 Spring Boot 项 目 带 来 了 很 多 有 用 的 特性 ， 包 括 : 


管理 端点 ; 

合理 的 异常 处 理 以 及 默认 的 “/error” 映 射 端点 ; 

获取 应 用 信息 的 %info” 端 点 ; 

当局 用 Spring Security 时 ， 会 有 一 个 审计 事件 框架 。 


这 些 特性 都 是 很 有 用 的 ， 但 Actuator 最 有 用 和 最 有 意思 的 特性 是 管理 端 
点 。 在 21.4 小 节 中 ， 我 们 将 会 看 到 Spring Boot Actuator 的 几 个 样 例 ， 它 
开 司 了 一 书 窗 ， 能 够 让 我 们 洞悉 应 用 的 内 部 运行 状况 。 


现在 ， 我 们 对 Spring Boot 的 四 个 主要 特性 已 经 有 了 基本 的 了 解 ， 接 下 来 
我 们 将 使 用 它们 构建 一 个 微小 但 完整 的 应 用 程序 。 





21.2 ”使 用 Spring Boot 构 建 应 用 


在 本 章 剩余 的 内 容 中 ， 我 将 会 回 你 展现 如 何 使 用 Spring Boot 构 建 完整 量 
符合 现实 要 求 〈real-world) 的 应 用 程序 。 当 然 , “符合 现实 要 求 ” 的 定义 
标准 会 有 些 争议 ， 对 它 的 讨论 超出 了 本 章 的 范围 。 因 此 ， 与 其 在 这 里 说 
构建 符合 现实 要 求 的 应 用 ， 还 不 如 后 退 一 步 ， 说 成 我 们 所 构建 的 应 用 程 
. 人 但 是 它 能 够 代表 使 用 Spring Boot 所 构建 的 更 大 
作用。 


我 们 的 应 用 是 一 个 简单 的 联系 人 列表 。 它 允许 用 户 输入 联系 人 信息 《名 
了 电话 号 码 以 及 Email 地 址 ) ， 并 且 能 够 列 出 用 户 之 前 输入 的 所 有 联 


SN 万 /Co 











你 可 以 自由 选择 使 用 Maven 还 是 Gradle 来 构建 应 用 程序 ， 我 更 喜欢 
Gradle， 但 是 如 果 你 喜欢 Maven 的 话 ， 我 也 将 会 列 出 所 需 的 Maven 代 

人 码 。 如 下 的 程序 清单 展现 了 起 始 的 build.gradle 文 件 。 开 始 的 时 候 ， 依 赖 
部 分 是 空 的 ， 但 是 在 这 个 过 程 中 ， 我 们 将 会 使 用 依赖 填充 这 部 分 的 内 


AS 


容 。 


程序 清单 21.1 Contacts 应 用 所 需 的 Gradle 构 建文 件 











buildscript { 
repositories { 
mavenLocal () 
} 
dependencies { 
classpath("org.springframework.boot:spring-boot-gradle-plugin: 
1.1.4.RELEASE") 
} 
， 


使 用 
Spring Boot 插件 


apply plugin: "Java' 
apply plugin: ‘spring-boot'" 


jar { < 一 构建 JAR 文件 
baseName = 'contacts'’ 


version = '‘'0.1.0' 


repositories { 


mavenCentral() 
dependencies { < 依赖 将 会 放 到 这 里 


task wrapper (type: Wrapper) { 
gradleVersion = '1.8' 


注意 ， 构 建 中 包含 对 Spring Boot Gradle 的 buildscript 依 赖 。 稍 后 将 会 
看 到 ， 这 会 帮助 我 们 生成 一 个 可 执行 的 超级 JAR 文 件 (uber-JAR) ， 这 
个 文件 中 将 会 包含 应 用 的 所 有 依赖 。 


J 的 话 ， 如 下 的 程序 清单 展现 了 完整 的 pom.xml 文 


程序 清单 21.2 Contacts 应 用 所 需 的 Maven 构 建文 件 


<?xml version="1.0" encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.o0rg/2001/xMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
http://maven.apache.org/xsd/maven-4.0.0.xsd'"> 


<modelVersion>4.0.0</modelVersion> 
<groupId>com.habuma</groupId> 
<artifactIid>contacts</artifactId> 
<version>0.1.0</version> 
<packaging>jar</packaging> < 构建 JAR 文件 
<parent> 
<groupId>org.springframework.boot</groupId> Ee 继承 自 


<artifactIid>spring-boot-starter-parent</artifactId> > 
Spring Boot 


starter parent 
<version>1.1.4.RELEASE</version> 
</parent> 


<dependencies> < 一 依赖 将 会 放 到 这 里 


</dependencies> 


<build> 
<plugins> 
“plugin> < 一 构建 JAR 文件 
<groupId>org.springframework .boot</groupId> 
<artifactIid>spring-boot-maven-plugin</artifactId> 
</plugin> 
</plugins> 
</build> 


</project> 


与 Gradle 构 建 类 似 ， 这 个 Maven 的 pom.xml 文 件 使 用 了 Spring Boot Maven 
插件 。 0 中 的 插件 对 应 于 Gradle 插 件 ， 能 够 生成 可 执行 的 超级 
JAR 文 件 。 


同样 需要 注意 的 是 ， 与 Gradle 构 建 不 同 ，Maven 构 架 有 一 个 parent 项 目 。 
我 们 让 项 目的 Maven 构 建 基于 Spring Boot starter parent， 这 样 的 话 ， 我 们 
就 能 受益 于 Maven 的 依赖 管理 功能 ， 对 于 项 目 中 的 很 多 依赖 ， 就 没有 必 
要 明确 声明 版 本 写 了 ， 因 为 版 本 号 会 从 parent 中 继承 得 到 。 


按照 Maven 和 Gradle 项 目的 标准 结构 ， 完 成 后 项 目 将 会 如 下 所 示 : 











$ tree 


| 一 build.gradle 


| LL contacts 
| 上 一 Application.java 
| CC Contact .java 
| 上 一 ContactController.java 
| [一 contactRepository.java 
[一 resources 

| 一 Schema .sdl 

上- static 

| [一 style.css 

LL templates 

LL home .html 


不 要 担心 现在 缺失 Java 和 其 他 的 资源 文件 。 在 开发 Contacts 应 用 的 过 程 
nn 首先 将 会 从 构建 应 用 
JWeb 层 开始 。 


21.2.1 处理 请 求 








因为 我 们 要 使 用 Spring MVC 来 开发 应 用 的 Web 层 ， 因 此 需要 将 Spring 
MVC 作 为 依赖 添加 到 构建 中 。 我 们 已 经 讨论 过 ，Spring Boot 的 Web 
Starter 能 够 将 Spring MVC 需 要 的 所 有 内 容 一 站 式 添 加 到 构建 中 。 如 下 是 
我 们 所 需 的 Gradle 依 赖 : 


compile("org.springframework.boot:spring-boot-starter-web") 





如 果 使 用 Maven 来 进行 构建 的 话 ， 那 么 依赖 将 会 如 下 所 示 ; 


<dependency> 
<groupId>org.springframework.boot</groupId> 


<artifactId>spring-boot-starter-web</artifactId> 
</dependency> 





注意 ， 因 为 Spring Boot parent 项 目 已 经 指定 了 Web Starter 依 赖 的 版 本 ， 
因此 在 项 目的 build.gradle 和 pom.xml 文 件 中 没有 必要 再 显 式 指定 版 本 信 
息 。 





Web Starter 依 赖 就 绪 之 后 ， 使 用 Spring MVC 需 要 的 所 有 依赖 都 会 添加 到 
项 目 中 。 现 在 ， 我 们 就 可 以 编写 应 用 所 需 的 控制 器 类 了 。 





控制 器 相对 会 非常 简单 ， 包 含 展 现 联 系 人 表单 的 HTTP GET 请 求 以 及 处 
理 表 单 提交 的 POST 请 求 。 它 本 号 并 没有 做 太 多 的 事情 ， 而 是 委 

托 ContactRepository〔 稍 后 束 会 创建 它 〉 来 持久 化 联系 人 信息 。 程 
序 清单 21.3 中 的 contactController 就 能 满足 这 些 需求 。 


程序 清单 21.3”ContactController 为 Contacts 应 用 处 理 基本 的 Web 请 求 


package contacts; 
import java.util.List; 


ort java.util.Map; 





t org,.springframework.beans.factory.annotation.Autowired; 





port org.springframework.stereotype.Controller; 
import org.springframework.web.bind.annotation.RequestMapping; 


import org.springframework.web.bind.annotation.ReaquestMethod; 


@Controller 
@RequestMapping("/") 
Public class ContactController { 


private ContactRepository contactRepo; 





注入 
@AL ContactRepositoy 
ouk ContactController (ContactRepository contactRepo) { < 













this.contactRepo contactRepo; 
@RequestMapping (method=RequestMethod.G ) 处 理 ET 
pu String home(Map<String 
I tact> ta S 
model t{"contact cont S 
turn home" 


处 理 POST“/” 





} 


你 首先 可 能 会 发 现 ContactController 就 是 一 个 典型 的 Spring MVC 控 
制 嚣 。 尺 管 Spring Boot 会 管理 构建 依赖 并 最 小 化 Spring 配置 ， 但 是 在 编 
写 应 用 逻辑 的 时 候 ， 编 程 模型 是 一 致 的 。 


在 本 例 中 ，ContactController 遵 循 了 Spring MVC 控 制 器 的 典型 模 

式 ， 它 会 展现 表单 并 处 理 表单 的 提交 。 其 中 home() 方 法 使 用 注入 的 
ContactRepository 来 获取 所 有 Contact 对 象 的 列表 ， 并 将 它们 放 到 模 
型 中 ， 然 后 把 请 求 转交 给 home 视 图 。 这 个 视图 将 会 展现 联系 人 的 列表 以 
及 添加 新 contact 的 表单 。submit() 方 法 将 会 处 理 表单 提交 的 POST 请 
求 ， 保 存 Contact， 并 重 定 向 到 首页 。 


因为 ContactController 使 用 了 @Controller 注 解 ， 所 以 组 件 扫 描 将 








会 找到 它 。 因 此 ， 我 们 不 需要 在 Spring 应 用 上 下 文中 明确 将 其 声明 为 


bean 。 


而 Contact 模 型 类 是 一 个 简单 的 POJO， 具 有 一 些 属性 和 存 取 器 方法 ， 
如 下 面 的 程序 清单 所 示 。 


程序 清单 21.4 ”Contact 是 一 个 简单 的 领域 类 型 


package contacts; 


public class Contact { 
private Long id; + 属性 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String emailAddress; 


public void setIQ(Long id) { < 一 存 取 器 方法 
this.id = id; 
} 


public Long getIQ() { 
return id; 


} 


public void setFirstName (String firstName) { 
this.firstName = firstName; 


} 


public String getFirstName() { 
return firstName; 


} 


public void setLastName (String lastName) { 
this.lastName = lastName; 

} 

Public String getLastName() { 
return lastName; 

} 


public void setPhoneNumber!{String phoneNumber) { 
this.phoneNumber = phoneNumber; 


} 


public String getPhoneNumber{) { 
return phoneNumber; 
} 


public void setEmailAddress{String emailAddress) { 
this.emailAddress = emailAddress; 
} 


public String getEmailAddress()} { 
return emailAddress; 
} 
} 


应 用 程序 的 Web 层 基本 上 已 经 完成 了 ， 剩 下 的 就 是 创建 定义 home 视 图 的 
Thymeleaf 模 板 。 


21.2.2 ”创建 视图 


按照 传统 的 方式 ，Java Web 应 用 会 使 用 JSP 作 为 视图 层 的 技术 。 但 是 ， 
正如 我 在 第 6 章 所 述 ， 在 这 个 领域 有 一 个 新 的 参与 者 。Thymeleaf 的 原生 
模板 比 JSP 更 加 便于 使 用 ， 而 且 它 能 够 让 我 们 以 HTML 的 形式 编写 模 
板 。 鉴 于 此 ， 我 们 将 会 使 用 Thymeleaf 来 定义 Contacts 应 用 的 home 视 图 。 


首先 ， 需 要 将 Thymeleafi 稚 加 到 项 目的 构建 中 。 在 本 例 中 ， 我 使 用 的 是 


Spring 4， 所 以 需要 将 Thymeleaf 的 Spring 4 模块 添加 到 构建 之 中 。 在 
Gradle 中 ， 依 赖 将 会 如 下 所 示 : 


compile("org.thymeleaf:thymeleaf-spring4") 


如 果 使 用 Maven 的 话 ， 所 需 的 依赖 如 下 所 示 : 





<dependency> 
<groupId>org.thymeleaf</groupId> 
<artifactId>thymeleaf-spring4</artifactId> 
</dependency> 


需要 记 住 的 是 ， 只 要 我 们 将 Thymeleaf 添 加 到 项 目的 类 路 径 下 ， 就 启用 
了 Spring Boot 的 自动 配置 。 当 应 用 运行 时 ，Spring Boot 将 会 探测 到 类 路 
径 中 的 Thymeleaf， 然 后 会 自动 配置 视图 解析 器 、 模 板 解 析 右 以 及 模板 
引擎 ， 这 些 都 是 在 Spring MVC 中 使 用 Thymeleaf 所 需要 的 。 因 此 ， 在 我 
们 的 应 用 中 ， 不 需要 使 用 显 式 Spring 配置 的 方式 来 定义 Thymeleaf 。 


除了 将 Thymeleaf 依 赖 添 加 到 构建 中 ， 我 们 剩 下 所 需要 做 的 耽 是 定义 视 
图 模板 。 程 序 清单 21.5 展 现 了 home.html， 这 是 定义 home 视 图 的 
Thymeleaf 模 板 。 


程序 清单 21.5 ”home 视图 泻 染 了 一 个 创建 新 联系 人 的 表单 以 及 展现 联 
系 人 的 列表 











<1DOCTYPE html> 
<html xmlns:th="http://www.thymeleaf .orG"> 
<head> 
<title>Spring Boot Contacts</title> 
<link rel="style " th:href="@{/style.css}" /> Ee 加 载 样式 表 
</head> 
<body> 


<h2>Spring Boot Contacts</h2> 
<form method="POST"> < 新 联系 人 的 表单 


<label for="firstName">First Name:</label> 

<input type="text" name="firstName"></,input><br/> 
<label for="lastName">Last Name:</label> 

<input type="text" name="lastName"></input><br/> 
<label for="phoneNumber">Phone #:</ © 





<input type="text" name="phoneNumber"></input><br/> 
<label for="emailAdd T / 2 > 
<input type="text" n "emailAddress"></input><br/> 
<input type="submit"></input> 
</form> 


<ul th:each="contact : ${contacts}"> < 泻 染 联系 人 列表 
<li> 
<span bh tk "ye ntact.firstName}">First</span> 
<span th:text="${contact. Tt >Last</span> : 
<span eas $s{contact .phoneNumber}">phoneNumber</span>, 
<span th:text="${contact.emailAddress}">emailAddress</span> 
EL 
</ul> 
</body> 


</html> 


它 实 际 上 是 一 个 非常 简单 的 Thymeleaf 模 板 ， 分 为 两 部 分 :一 个 表单 和 
一 个 联系 人 的 列表 。 表 单 将 会 POST 数据 到 ContactController 的 
submit() 方 法 上 ， 用 来 创建 新 的 Contact。 列 表 部 分 将 会 循环 列 出 模 
型 中 的 Contact 对 象 。 


为 了 使 用 这 个 模板 ， 我 们 需要 对 其 进行 慎重 地 命名 并 放 在 项 目的 正确 位 
置 下 。 因 为 ContactController 中 home() 方 法 所 返回 的 逻辑 视图 名 

为 home， 因 此 模板 文件 应 该 命名 为 home.html， 自 动 配置 的 模板 解析 器 
会 在 指定 的 目录 下 查找 Thymeleaf 模 板 ， 这 个 目录 也 就 是 相对 于 根 类 路 
径 下 的 templates 目 录 下 ， 所 以 在 Maven 或 Gradle 项 目 中 ， 我 们 需要 将 


home.html 放 到 “src/main/ resources/templates” 中 。 


这 个 模板 还 有 一 点 小 事情 需要 处 理 ， 它 所 产生 的 HTML 将 会 引用 名 为 
style.css 的 样式 表 。 因 此 ， 需 要 将 这 个 样式 表 放 到 项 目 中 。 








21.2.3 ”添加 静态 内 容 
正常 来 讲 ， 在 编写 Spring 应 用 时 ， 我 会 尽量 避免 讨论 样式 和 图 片 。 当 





然 ， 这 些 内 容 能 够 在 很 大 程度 上 让 各 种 应 用 《包括 Spring 应 用 ) 变 得 更 
加 美观 ， 令 用 户 呐 心 悦 目 。 但 是 ， 对 于 编写 服务 器 端的 Spring 代码 来 
说 ， 这 些 静 态 内 容 束 没有 那么 重要 了 。 


但 是 ， 在 Spring Boot 中 ， 有 必要 讨论 一 下 它 是 如 何 处 理 静 态 内 容 的 。 当 
采用 Spring Boot 的 Web 自 动 配置 来 定义 Spring MVC bean 时 ， 这 些 bean 中 
会 包含 一 个 资源 处 理 器 (resource handler) ， 它 会 将 “/**” 映 射 到 几 个 资 
源 路 径 中 。 这 些 资 源 路 径 包 括 ( 相 对 于 类 路 径 的 根 〉: 


/ME'TA-INF/resources/ 
/resources/ 

/static/ 

/public/ 


在 传统 的 基于 Maven/Gradle 构 建 的 项 目 中 ， 我 们 通常 会 将 静态 内 容 放 
在 “src/main/webapp” 目 录 下 ， 这 样 在 构建 所 生成 的 WAR 文 件 里 面 ， 这 些 
内 容 束 会 位 于 WAR 文 件 的 根 目录 下 。 如 有 果 使 用 Spring Boot 构 建 WAR 文 
件 的 话 ， 这 依然 是 可 选 的 方案 。 但 是 ， 我 们 也 可 以 将 静态 内 容 放 在 资源 
处 理 器 所 映射 的 上 述 四 个 路 径 下 。 


所 以 ， 为 了 满足 Thymeleaf 模 板 对 “/style.css” 文 件 的 引用 ， 我 们 需要 创建 
一 个 名 为 style.css 文 件 ， 并 将 其 放 到 如 下 所 示 的 某 一 个 位 置 中 : 


/META-INF/resources/style.css 
/resources/style.css 
/static/style.css 

/public/style.css 


具体 的 选择 完全 取决 于 你 ， 我 倾 癌 于 将 静态 内 容 放 到 “public" 中 ， 不 过 
这 四 个 可 选 方案 是 等 价 的 。 


尽管 style.css 文 件 的 内 容 与 讨论 无 天， 但 是 如 下 这 个 简单 的 样式 表 能 够 
让 应 用 看 上 去 更 加 整洁 : 





body { 
background-color: #eeeeee; 
font-family: sans-serif; 


} 


label { 
display: inline-block; 
width: 126px; 
text-align: right; 

} 





不 管 你 是 否 相 信 ， 对 于 这 个 简单 的 Contacts 应 用 来 说 ， 我 们 已 经 完成 了 
超过 一 半 的 任务 ! Web 层 全 部 完成 了 ， 接 下 来 我 们 需要 创建 
ContactRepository， 用 来 处 理 Contact 对 象 的 持久 化 。 


21.2.4 持久 化 数据 


在 Spring 应 用 中 ， 有 多 种 使 用 数据 库 的 方式 。 我 们 可 以 使 用 卫 了 A 或 
Hibernate 将 对 象 映射 为 关系 型 数据 库 中 的 表 和 列 。 或 者 ， 我 们 干脆 放弃 
关系 型 数据 库 ， 使 用 其 他 类 型 的 数据 库 ， 如 Mongo 或 Neo4j。 


对 于 Contacts 应 用 来 说 ， 关 系 型 数据 库 是 不 错 的 选择 。 我 们 将 会 使 用 H2 
数据 库 和 JDBC (使 用 Spring 的 JdbcTemplate) ， 让 这 个 过 程 尽 可 能 地 
简单 。 








选择 这 种 方案 就 需要 在 构建 中 添加 一 些 依赖 。JDBC Starter 依 赖 会 将 
Spring JdbcTemp1late 需 要 的 所 有 内 容 都 引入 进来 。 不 过 ， 要 结合 使 用 
H2 数 据 库 的 话 ， 我 们 还 需要 添加 H2 依 赖 。 如 果 使 用 Gradle 的 话 ， 

在 dependencies 代 码 块 添加 如 下 两 行 代码 就 能 完成 这 项 任务 : 





compile("org.springframework.boot:spring-boot-starter-jdbc") 





compile("com.h2database:h2") 





人 我 们 需要 如 下 的 两 个 cdependency> 人 代码 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-jdbc</artifactId> 
</dependency> 


<dependency> 
<groupId>com.h2database</groupId> 
<artifactId>h2</artifactId> 
</dependency> 





将 这 两 项 依赖 添加 到 构建 之 中 后 ， 我 们 就 可 以 编写 Repository 类 了 。 如 
下 程序 清单 中 的 ContactRepository 将 会 使 用 注入 的 JdbcTemplate 实 
现在 数据 库 中 读 取 和 写 入 Contact 对 象 。 


程序 清单 21.6 ”ContactRepository 能 够 从 数据 库 中 存 取 Contact 


package contacts; 

import java.util.List; 

import java.sgql.ResultSet; 

import java.sql.SQbLException; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.jdbc.core.JdbcTemplate; 

import org.springframework.jAbc.core.RowMapper:; 

import org.springframework.stereotype.Repository; 


@Repository 
public class ContactRepository { 
private JdbcTemplate jdbe; 
@Autowired 
public ContactRepository lJdbcTemplate jdbc) ({ < 一 注入 JdbcTemplate 
this.jdbc = jdbc; 
} 


public List<Contact> findall() { 查询 联系 人 
return jdbc.query!{ 4 
"select id, firstName, lastName, phoneNumber, emailAddress " + 
"from contacts order by lastName", 
new RowMapper<Contact>() { 
public Contact mapRow(ResultSet rs, int rowNum) 
throws SQLException { 
Contact contact = new Contact(); 
contact.setIid(rs.getLong(1)); 
contact.setFirstName (rs.getstring(2)); 
contact.setLastName (rs.getSstring(3)); 
contact.setPhoneNumber (rs.getstring(4)); 
contact.setEmailAddress (rs.getSstring(S5)); 
return contact; 
} 
二 
} 


public void save(lContact contact) 1 
jdbc .update! < 一 插入 联系 人 
"insert into contacts "+ 
"(firstName, lastName, phoneNumber, emailAddress) " + 
ei 
contact .getFirstName{(), contact .getLastName!{(), 
contact .getPhoneNumber{), contact.getEmailAddress()); 


与 ContactController 类 似 ， 这 个 Repository 类 非常 简单 。 它 与 传统 
Spring 应 用 中 的 Repository 类 并 没有 什么 差别 。 从 实现 中 ， 根 本 无 法 看 出 
它 要 用 于 Spring Boot 的 应 用 程序 中 。findA1l1() 方 法 使 用 注入 的 
JdbcTemplate 从 数据 库 中 获取 Contact 对 象 ，save( ) 方 法 使 用 注入 的 





JdbcTemplate 保 存 新 的 Contact 对 象 。 因 为 ContactRepository 使 用 
了 @Repository 注 解 ， 因 此 在 组 件 扫 拉 的 时 候 ， 它 会 被 发 现 并 创建 为 
Spring 应 用 上 下 文中 的 bean。 


但 是 ，JdbcTemp1late 呢 ?我们 难道 不 需要 在 Spring 应 用 上 下 文中 声 
明 JdbcTemplatebean 吗 ?为 了 声明 它 ， 我 们 是 不 是 还 要 声明 一 个 H2 
DataSource? 





对 这 两 个 问题 的 简短 问答 就 是 “不 需要 ”。 当 Spring Boot 探 测 到 Spring 的 
JDBC 模 块 和 H2 在 类 路 径 下 的 时 候 ， 自 动 配置 就 会 发 挥 作用 ， 将 会 自动 
配置 J]dbcTemplatebean 和 H2DataSourcebean。Spring Boot 再 一 次 为 我 
们 处 理 了 所 有 的 Spring 配置 。 


那 数 据 库 模 式 该 怎么 处 理 呢 ? 我 们 必须 要 目 己 来 定义 创建 contacts 表 
的 模式 ， 对 不 对 ? 


这 绝对 是 正确 的 ! Spring Boot 没 有 办 法 猜测 contacts 表 会 是 什么 样 
子 。 所 以 ， 我 们 需要 定义 模式 ， 如 下 上 所 示 : 








create table contacts ( 
id identity, 
firstName varchar(36) not null, 
lastName varchar(56) not null, 


phoneNumber varchar(13), 
emailAddress varchar(36) 








现在 ， 我 们 只 需要 有 一 种 方式 加 载 这 个 “create table” 的 SQL 并 将 其 
在 H2 数 据 库 中 执行 就 可 以 了 。 广 好，Spring Boot 也 涵 羡 了 这 项 功能 。 如 
果 我 们 将 这 个 文件 命名 为 schema.sql 并 将 其 放 在 类 路 径 根 下 (也 就 是 
Maven 或 Gradle 项 目的 “src/main/resources” 有 目录 下 ) ， 当 应 用 启动 的 时 
候 ， 就 会 找到 这 个 文件 并 进项 数据 加 载 。 


21.2.5” 壬 试 运行 
Contacts 应 用 非常 简单 ， 但 是 也 算得 上 现实 中 的 Spring 应 用 。 它 具有 


Spring MVC 控 制 右 和 Thymeleaf 模 板 所 定义 的 Web 层 ， 并 且 具 有 
Repository 和 Spring JdbcTemplate 所 定义 的 持久 层 。 





到 此 为 止 ， 我 们 已 经 编写 完了 Contacts 所 需 的 应 用 级 别 代 码 。 不 过 ， 我 
们 还 没有 编写 任何 形式 的 配置 。 我 们 没有 编写 任何 Spring 配 置 ， 也 没有 
在 web.xml 或 Servlet 初 始 化 类 中 配置 DispatcherServlet。 


如 果 我 说 不 需要 编写 任何 的 配置 ， 你 会 相信 吗 ? 


这 应 该 做 不 到 吧 ， 毕 竟 在 对 Spring 的 批评 中 ， 人 们 都 在 说 Spring 全 是 配 
置 ， 肯 定 有 我 们 忽略 挥 的 XML 文 件 或 Java 配 置 类 。 我 们 所 编写 的 Spring 
应 用 程序 根本 就 不 可 能 没有 任何 配置 的 .…… 那 么 ， 我 们 到 底 能 做 到 吗 ”? 


通常 来 讲 ，Spring Boot 的 目 动 配 置 特性 消除 了 绝 大 部 分 或 者 全 部 的 配 
置 。 因 此 ， 完 全 可 能 编写 出 没有 任何 配置 的 Spring 应 用 程序 。 当 然 ， 目 
动 配置 并 不 能 涵盖 所 有 的 场景 ， 因 此 典型 的 Spring Boot 应 用 程序 依然 会 
需要 一 点 配置 。 


具体 到 Contacts 应 用 ， 我 们 不 需要 任何 的 配置 。Spring 的 自动 配置 功能 
经 将 所 有 的 事情 都 做 好 了 。 


但 是 ， 我 们 需要 有 个 特殊 的 类 来 启动 Spring Boot 应 用 。Spring 本 里 并 不 
知道 自动 配置 的 任何 信息 。 程 序 清单 21.7 中 的 Application 类 就 是 Spring 
Boot 启 动 类 的 典型 例子 。 


程序 清单 21.7 初始 化 Spring Boot 配 置 的 简单 启动 类 














import org.springframework.boot.autoconfigure.EnableAutoConfiguration; 
: "kt 9 





SpringApplication.run{lApplication.class, args); < 运行 应 用 
1 


好 吧 ， 我 承认 Application 中 有 那么 一 点 配置 。 它 使 

用 Q@Componentscan 注 解 来 局 用 组 件 扫 描 ， 另 外 它 还 使 用 了 
@EnableAutoConfiguration， 这 会 启用 Spring Boot 的 自动 配置 特性 。 
也 就 这 么 多 了 ! 除了 这 两 行 代 码 以 外 ，Contacts 再 也 没有 什么 配 








App1lication 类 最 有 意思 的 一 点 在 于 它 共 有 一 个 main() 方 法 。 稍 后 将 
会 看 到 ，Spring Boot 应 用 会 以 一 种 特殊 的 方法 运行 ， 正 是 这 里 的 main() 
方法 使 这 一 切 成 为 可 能 。 在 main() 方 法 中 ， 这 行 代 码 会 告诉 Spring 
Boot 〈 通 过 SpringApp1lication 类 ) 根据 Application 中 的 配置 以 及 
命令 行 中 的 参数 来 运行 。 

现在 ， 我 们 马上 就 可 以 运行 应 用 了 。 剩 下 就 是 要 进行 构建 。 如 果 使 用 


Gradle 的 话 ， 那 么 如 下 的 命令 行 会 将 项 目 构建 到 build/libs/contacts- 
0.1.0.jar” 中 : 


$ gradle build 


如 果 你 喜欢 Maven 的 话 ， 那 么 可 以 按照 如 下 的 方式 构建 项 目 : 


运行 Maven 构 建 后 ， 你 会 在 target 文 件 夹 下 找到 构建 形成 的 结果 。 


现在 ， 我 们 就 可 以 运行 它 了 。 按 照 传 统 的 方式 ， 这 意味 着 要 将 应 用 的 
WAR 文 件 部 署 到 Servlet 容 器 中 ， 如 Tomcat 或 WebSphere。 但 是 在 这 里 ， 
我 们 甚至 没有 WAR 文 件 一 一 构建 形成 的 是 一 个 JAR 文 件 。 


这 没有 什么 问题 。 我 们 可 以 按照 如 下 的 方式 从 命令 行 运行 它 (引用 的 是 
基于 Gradle 构 建 的 JAR 文 件 ) : 


$ java -jar build/libs/contacts-0.1.06.jar 


在 几 秒 钟 后 ， 应 用 应 该 已 经 局 动 完成 并 且 可 以 访问 了 。 打 开 浏 览 器 进 
入 http:/localhost:8080， 你 就 应 该 可 以 输入 联系 人 了 。 在 输入 几 个 联系 
人 后 ， 浏 览 右 将 会 如 图 21.1 所 示 。 


你 可 能 党 得 这 并 不 符合 Web 应 用 的 运行 方式 。 像 这 样 从 命令 行 运行 应 用 
非常 简洁 和 方便 ， 但 是 ， 对 于 你 来 讲 ， 也 许 这 并 不 理想 。 在 你 所 工作 的 
环境 中 ， 有 可 能 需要 将 Web 应 用 作为 WAR 文 件 部 署 到 Web 容 器 中 。 如 来 
不 提交 WAR 文 件 的话 ， 可 能 不 满足 公司 的 部 署 策 上 略 。 























人 日 日 Spring Boot Contacts 
| 珍 几 士 | 加 localhost:8080 © 册 ae ic 








Spring Boot Contacts 


First Name: 
Last Name: 
Phone #: 
Email: 

Submit 


。 Jack Diamond : 312-123-4984, jdiamond@knowjack.com 

。 Shelby Mayer : 310-873-4394, shelby@howdareyou.com 

。 Percivel Peabody : 415-555-1200, peabody@hollywoodpd.gov 
。 Evie Starlight : 714-338-7248, evie @sparkle.net 


图 21.1 Spring Boot Contacts 应 用 
好 的 ， 那 也 没有 问题 。 
即便 是 对 于 生产 环境 ， 通 过 命令 行 来 运行 应 用 也 是 合理 的 方案 ， 但 是 我 
理解 你 可 能 需要 遵循 公司 的 部 署 流程 。 这 意味 着 需要 构建 和 部 署 WAR 
文件 。 
好 消息 是 ， 如 果 你 需要 WAR 文 件 的 话 ， 并 没有 必要 舍弃 Spring Boot 的 简 


洁 性 。 需 要 做 的 事情 仅仅 是 稍微 调整 一 下 构建 文件 。 在 Gradle 构 建 中， 
我 们 需要 添加 如 下 这 行 代码 来 应 用 “war” 插 件 : 














apply plugin: ‘war' 


除 此 之 外 ， 还 需要 将 “jar" 配 置 调整 为 "war"。 这 实际 上 就 是 将 "> 蔡 换 
为 “w”: 


war { 
baseName = 'contacts' 


version = '060.1.0" 


} 





如 果 是 Maven 构 建 的 项 目 ， 那 会 更 加 简单 。 只 需 将 packaging 从 “jar” 替 换 
为 “war” 即 可: 


<packaging>war</packaging> 


现在 ， 我 们 可 以 重新 构建 项 目 ， 然 后 将 会 在 构建 目录 中 找到 contacts- 
0.1.0.war 文 件 。 这 个 WAR 文 件 文件 可 以 部 四 到 任意 支持 Servlet 3.0 的 容 
器 中 。 另 外 ， 我 们 依然 可 以 在 命令 行 中 运行 这 个 应 用 : 


$ java -jar build/1ibs/contacts-96.1.6.war 


ee 对 于 两 种 场景 来 说 ， 这 都 是 最 佳 
和 J 方案 。 
我 们 可 以 看 到 ，Spring Boot 能 够 在 很 大 程度 上 尽 可 能 简化 Spring 应 用 的 


部 闭 。Spring Boot Stater 人 简化 了 项 目 构建 的 依赖 ， 上 自动 配置 消除 了 显 式 
的 Spring 配 置 。 但 稍 后 你 会 看 到 ， 如 果 再 结合 Groovy， 它 会 更 加 简单 。 











21.3 组 合 使 用 Groovy 与 Spring Boot CLI 


Groovy 编 程 语言 要 比 Java 人 简单 得 多 。 它 的 语法 允许 有 一 些 快捷 方式 ， 比 
如 省 略 分 号 和 pub1ic 关 键 词 。 同 时 ，Groovy 类 中 的 属性 不 像 Java 那 样 需 
要 Setter 和 Getter 方 法 。 当 然 ，Groovy 还 有 其 他 的 一 些 属 性 ， 能 够 消除 
Java 代 码 中 很 多 的 索 文 丝 节 。 


如 果 你 愿意 使 用 Groovy 编 写 应 用 代码 并 通过 Spring Boot CLI 运 行 的 话 ， 
那么 Spring Boot 能 够 借助 Groovy 的 简洁 性 进一步 简化 Spring 应 用 。 为 了 
前 述 这 一 点 ， 我 们 使 用 Groovy 来 重新 编写 Contacts 应 用 程序 。 


为 什么 不 呢 ? 在 初始 版 本 的 应 用 中 ， 我 们 只 有 几 个 小 的 Java 类 ， 因 此 使 
用 Groovy 进 行 重 写 也 没有 太 多 的 工作 量 。 我 们 可 以 重用 相同 的 
Thymeleaf 模 板 和 schema.sql 文 件 。 既 然 我 宣称 Groovy 能 够 进一步 简化 
Spring， 那 重 写 应 用 也 不 是 什么 大 事 儿 。 


在 这 个 过 程 中 ， 我 们 还 会 移 除 一 些 代 码 。Spring Boot CLI 本 喘 承 是 局 动 
器 ， 所 以 不 再 需要 前 面 所 创建 的 Application 类 。Maven 和 Gradle 构 建 
文件 也 不 再 需要 了 ， 因 为 我 们 将 会 通过 CLI 运 行 未 编译 的 Groovy 文 件 。 
少 了 Maven 和 Gradle 之 后 ， 项 目的 整体 结构 将 会 变 得 更 加 局 平 化 ， 新 的 
项 目 结构 将 会 如 下 所 示 : 


$ tree 























| 一 Contact .groovy 

-一 ContactController.groovy 

| 一 ContactRepository.groovy 

一 schema.sal 

| 一 static 

| 上 -一 style.css 

LL templates 
[一 home .html 


schema.sql、style.css 和 home.html 将 会 保持 原样 ， 但 是 需要 将 Java 类 转换 
为 Groovy。 我 们 先 从 使 用 Groovy 编 写 Web 层 开始 。 


21.3.1 编写 Groovy 控 制 器 


如 前 所 述 ，Groovy 不 像 Java 那 样 有 很 多 的 繁 文 手 庆 。 这 意味 着 我 们 在 编 
写 Groovy 代 码 的 时 候 ， 可 以 省 略 如 下 的 内 容 : 











分 号 ; 


像 public 和 private 这 样 的 修饰 符 ; 
属性 的 Setter 和 Getter 方 法 ; 
方法 返回 值 的 retum 关 键 字 。 


借助 Groovy 更 加 灵活 的 语法 〈 以 及 Spring Boot 的 魔力 ) ， 我 们 可 以 使 用 
Groovy 重 写 ContactController 类 ， 如 程序 清单 21.8 所 示 。 


程序 清单 21.8 使 用 Groovy 编 写 的 ContactController 要 比 使 用 Java 更 简 


@Grab("thymeleaf-spring4") l 获得 
@Controller Thymeleaf 依赖 





@Autowired 
ContactRepository contactRepo 4 注 人 ContactRepository 


处 理 对 “/” 的 GET 请 求 


处 理 对 “/” 的 POST 请 求 





} 


我 们 可 以 看 到 ， 这 个 版 本 的 ContactController 要 比 对 应 的 Java 版 本 更 
加 人 简洁。 排除 挥 Groovy 不 需要 的 内 容 后 ，ContactController 更 加 简 
短 也 更 易于 阅读 。 


程序 清单 21.8 还 移 除 了 一 些 内 容 ， 你 可 能 也 发 现 了 ， 这 里 没有 import 代 
码 行 ， 在 Java 代 码 中 这 是 很 常见 的 。Groovy 默 认 会 导入 一 些 包 和 类 ， 包 
括 : 





java.10.* 

java.lang.* 
java.math.BigDecimal 
java.math.BigInteger 
Java.net.* 


e@ java.util.* 
e groovy.lang.* 
e groovy.util.* 


因为 有 了 这 些 默 认 的 导入 ， 所 以 ContactController 就 不 需要 导 
入 List 类 了 。 这 个 类 位 于 java.util 包 中 ， 包 含 在 默认 的 导入 里 面 。 


但 是 ， 像 @Controller、@RequestMapping、@Autowired 以 及 
@RequestMethod 这 样 的 Spring 类 型 该 怎么 处 理 呢 ? 它们 没有 位 于 默认 
的 导入 中 ， 我 们 该 如 何 省 略 import 代 但 行 呢 ? 


稍 后 ， 当 我 们 运行 应 用 的 时 候 ，Spring Boot CLI 将 会 试图 使 用 Groovy 编 
译 堪 编译 这 些 Groovy 类 。 因 为 这 些 类 型 没有 导入 进来 ， 所 以 将 会 导致 编 
详 尖 败 : 


但 是 ，Spring Boot CLI 却 不 会 就 这 样 轻易 放弃 ， 在 这 里 CLI 将 自动 配置 

达到 了 一 个 新 高 度 。CLI 将 会 识别 出 失败 是 因为 缺少 Spring 类 型 ， 它 会 

采取 两 个 步骤 来 修正 这 个 问题 。 首 先 会 获取 Spring Boot Web Starter 依 赖 
并 将 其 依赖 的 其 他 内 容 都 添加 到 类 路 径 下 〈 这 样 会 下 载 并 添加 JAR 到 类 
路 径 下 ) 。 然 后 ， 它 会 将 必要 的 包 添 加 到 Groovy 编 译 器 的 默认 导入 列表 
中 ， 然 后 重新 尝试 编译 代码 。 


CLI 这 种 自动 添加 依赖 /自动 导入 的 结果 就 是 我 们 的 控制 器 类 不 需要 任何 
的 import 语 句 了 ， 并 且 我 们 没有 必要 再 手动 或 者 通过 Maven、Gradle 来 解 
析 Spring 库 。Spring Boot CLI 将 会 为 我 们 完成 所 有 的 事情 。 


现在 ， 让 我 们 后 退 一 步 ， 考 虑 一 下 这 里 都 发 生 了 什么 。 通 过 在 代码 中 使 
用 Spring MVC 类 型 ， 如 @Controller 或 @RequestMapping，CLI 将 会 自 
动 解析 Spring Boot Web Starter 依 赖 。 将 Web Starter 的 依赖 传递 添加 到 类 

路 径 之 后 ，Spring Boot 的 自动 配置 将 会 发 挥 作用 ， 它 会 为 我 们 自动 配置 
Spring MVC 功 能 所 需 的 bean。 不 过 ， 在 这 里 我 们 需要 做 的 仅仅 是 使 用 这 
些 类 型 ，Spring Boot 将 会 处 理 所 有 的 事情 。 


当然 ，CLI 的 功能 也 会 有 一 些 限制 。 尽 管 它 知道 如 何 解析 众多 的 Spring 
依赖 ， 并 且 能 够 自动 将 很 多 Spring 类 型 (以 及 很 多 其 他 的 库 ) 添加 到 导 
入 中 ， 但 是 它 不 能 自动 解析 和 导入 所 有 的 功能 。 例 如 ， 使 用 Thymeleaf 
模板 是 一 个 可 将 换 的 方案 ， 所 以 要 在 代码 中 通过 @Grab 显 示 声 明 。 











还 要 注意 ， 很 多 的 依赖 都 没有 必要 指定 group ID 和 版 本 号 。Spring Boot 
rab 依 赖 的 时 候 参 与 进来 ， 将 缺失 的 group ID 和 版 本 号 添 
下 


借助 @Grab 注 解 ， 我 们 声明 了 要 使 用 Thymeleaf， 这 会 触发 自动 配置 功 
能 ， 将 会 自动 配置 在 Spring MVC 中 支持 Thymeleaf 模 板 所 需 的 bean。 


尽管 Contact 类 与 Spring Boot 没 有 太 大 关系 ， 但 为 了 样 例 的 完整 性 ， 我 还 
是 将 它 的 Groovy 代 人 码 展现 在 了 下 面 : 











class Contact { 
long id 
String firstName 


String lastName 
String phoneNumber 
String emailAddress 





可 以 看 到 ，Contact 也 更 加 简洁 ， 没 有 分 号、 存 取 器 方法 以 及 像 public 
和 private 这 样 的 修饰 符 。 这 完全 归功 于 Groovy 人 简单 的 语法 ， 其 实 
Spring Boot 并 没有 参与 简化 Contact 类 。 


接 下 来 ， 我 们 看 一 下 如 何 借助 Spring Boot CLI 和 Groovy 来 简化 Repository 
类 
人 R。 





21.3.2 ”使 用 Groovy Repository 实 现 数据 持久 化 
ContactController 中 所 用 到 的 Groovy 和 Spring Boot CLI 技 巧 都 可 以 应 
用 到 ContactRepository 中 。 如 下 的 程序 清单 展现 了 Groovy 版 本 的 


ContactRepository。 


程序 清单 21.9 ”使 用 Groovy 编 写 时 ，ContactRepository 会 更 加 简洁 


eGrab("h2") < 
We 获取 H2 


import java.sql.ResultSet 数据 库 的 依赖 
class ContactRepository { 
@Autowired 
JdbcTemplate jdbc 4 注入 JdbcTemplate 


List<Contact> findAll() { - 查询 联系 人 
jabc .Guery 





上 id, firstName, lastName, phoneNumber, emailAddress " + 
"from contacts order by lastName", 
new RowMapper<Contact>() { 

Contact mapRow(ResultSet rs, int rowNum) { 


new Contact(id: rs.getLong(1), firs me: rs.getstring(2), 





lastName: rs.getstring(3), phoneNumber: rs.getstring(4), 





emailAddress: rs.getSstring{S)) 
9 
}) 
} 
void save(Contact contact) { < 保存 联系 人 
jabc.updaatel 
"insert into contacts " + 
"(firstName, lastName, phoneNumber, emailAddress) " + 


ENET 
contact .firstName，contact .1astName， 


contact.phoneNumber, contact.emailAddress) 


除了 Groovy 在 语法 方面 带 来 的 明显 改善 ， 这 个 新 版 的 
ContactRepository 类 使 用 了 Spring Boot CLI 自 动 导入 JdbcTemplate 
和 RowMapper。 除 此 之 外 ， 当 CLI 友 现 我 们 使 用 这 些 类 型 的 时 候 ， 将 会 
自动 解析 JDBC Starter 依 赖 。 


只 有 两 件 事情 是 CLI 的 自动 导入 和 目 动 解析 无 法 帮助 我 们 的 。 可 以 看 
到 ， 我 们 依然 需要 导入 ResultSet。 男 外 ，Spring Boot 无 法 知道 我 们 使 
用 哪 种 数据 库 ， 因 此 必须 要 使 用 @Grab 注 解 添加 H2 数 据 库 。 


我 们 已 经 将 所 有 Java 类 转换 成 了 Groovy 并 在 这 个 过 程 中 发 挥 了 Spring 
Boot 的 魔力 。 现 在 ， 我 们 可 以 运行 应 用 了 。 





21.3.3 ”运行 Spring Boot CLI 





在 编译 完 Java 应 用 之 后 ， 有 两 种 方法 来 运行 它 。 我 们 可 以 按照 可 执行 
JAR 或 WAR 文 件 的 形式 在 命令 行 运行 ， 也 可 以 将 WAR 文 件 部 周到 
Servlet 容 器 中 运行 。Spring Boot CLI 提 供 了 第 三 种 可 选 方案 。 





从 名 字 应 该 也 能 猜 得 出 来 ， 通 过 Spring Boot CLI 运 行 应 用 需要 使 用 命令 


行 。 但 是 ， 借 助 CLI， 我 们 不 需要 首先 将 应 用 构建 为 JAR 或 WAR 文 件 。 
运行 应 用 的 时 候 ， 我 们 可 以 直接 将 Groovy 源 码 传 给 CLI。 


安装 CLI 


ns Boot CLI， 我 们 需要 安装 它 。 有 多 种 方案 可 供 选 择 ， 包 
舌 : 





。 Groovy 环 境 管 理 器 (Groovy Environment Manager,， GVM) ; 
。 Homebrew:; 


。 手 动 安装 。 
如 果 使 用 GVM 安 装 CLI 的 话 ， 输 入 以 下 命令 : 


你 如 果 使 用 OS X 的 话 ， 我 们 可 以 使 用 Homebrew 来 安装 Spring Boot 
CLI: 


$ brew tap pivotal/tap 

$ brew install springboot 

如 果 你 愿意 手动 安装 Spring Boot 的 话 ， 那 么 可 以 下 载 并 按照 该 站 点 
http://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/ 的 指南 进 
行 安 装 。 


CLI 安 装 完成 之 后 ， 可 以 使 用 如 下 的 命令 检查 安装 情况 以 及 当前 使 用 的 
古 哪个 版 本 : 


ssprine version | 
假设 安装 没有 问题 的 话 ， 那 就 可 以 运行 Contacts 应 用 了 。 


使 用 CLI 运 行 Contacts 应 用 





要 使 用 Spring Boot CLI 运 行 应 用 的 话 ， 我 们 需要 在 命令 行 输入 Spring 
run， 然 后 后 面 再 加 上 要 通过 CLI 运 行 的 一 个 或 多 个 Groovy 文 件 。 例 如 ， 
如 果 应 用 只 有 一 个 Groovy 文 件 的 话 ， 那 么 可 以 这 样 运行 : 





$ spring run Hello.groovy 


这 样 就 会 通过 CLI 运 行 一 个 名 为 Hello.groovy 的 Groovy 类 。 


如 果 你 的 应 用 有 多 个 Groovy 类 文件 的 话 ， 那 么 可 以 通过 通配符 来 运行 ， 
如 下 所 示 ; 


$ spring run *.groovy 


或 者 ， A EA 个 或 多 个 子 日 录 下 ， 那 么 我 们 可 
以 使 用 Ant 风 格 的 通配符 递归 查找 Groovy 类 : 


$ spring run **/*.groovy 


因为 Contacts 应 用 有 三 个 需要 读 取 的 Groovy 类 ， 而 且 它 们 都 位 于 项 目的 
根 目 录 下 ， 所 以 上 述 的 后 两 种 方案 都 是 可 行 的 。 在 运行 应 用 之 后 ， 我 们 
就 能 够 在 浏览 器 中 访问 http://localhost:8080， 并 且 能 够 在 浏览 器 中 看 到 

与 之 前 相同 的 Contacts 应 用 。 


到 此 为 止 ， 我 们 以 两 种 方式 编写 了 Spring Boot 应 用 : 一 种 使 用 Java， 男 
一 种 使 用 Groovy。 在 这 两 种 情况 中 ，Spring Boot 在 最 小 化 模板 配置 以 及 
构建 依赖 方面 都 发 挥 了 很 大 的 作用 。Spring Boot 还 有 另外 一 项 功能 。 让 
我 们 看 一 下 如 何 借助 Spring Boot Actuator 为 Web 应 用 引入 管理 端点 








21.4 通过 Actuator 获 取 了 解 应 用 内 部 状况 


Spring Boot Actuator 所 完成 的 主要 功能 就 是 为 基于 Spring Boot 的 应 用 添 
加 多 个 有 用 的 管理 端点 。 这 些 端 点 包括 以 下 几 个 内 容 。 


GET /autoconfig: 描述 了 Spring Boot 在 使 用 自动 配置 的 时 候 ， 所 
做 出 的 决策 ; 

。GET /beans: 列 出 运行 应 用 所 配置 的 bean; 

GET /configprops: 列 出 应 用 中 能 够 用 来 配置 bean 的 所 有 属性 及 
其 当前 的 值 ; 

GET /dump: 列 出 应 用 的 线程 ， 包 括 每 个 线程 的 栈 跟 踪 信 息 ，; 

GET /env: 列 出 应 用 上 下 文中 所 有 可 用 的 环境 和 系统 属性 变量 ; 
GET /env/{name}: 展现 某 个 特定 环境 变量 和 属性 变量 的 值 ; 
GET /health: 展现 当前 应 用 的 健康 状况 ; 

GET /info: 展现 应 用 特定 的 信息 ; 

> /metrics: 列 出 应 用 相关 的 指标 ， 包 括 请 求 特定 端点 的 运行 
次 数 ; 

GET /metrics/{name}: 展现 应 用 特定 指标 项 的 指标 状况 ; 

POST /shutdown: 强制 关闭 应 用 ; 

。 /trace: 列 出 应 用 最 近 请 求 相 关 的 元 数据 ， 包 括 请 求 和 啊 应 




















为 了 局 用 Actuator， 我 们 只 需 将 Actuator Starter 依 赖 添加 到 项 目 中 即 可 。 
如 果 你 使 用 Groovy 编 写 应 用 并 通过 Spring Boot CLI 来 运行 ， 那 么 可 以 通 
过 @Grab 注 解 来 添加 Actuator Starter， 如 下 所 示 : 


@Grab("spring-boot-starter-actuator") 


如 有 果 使 用 Gradle 构 建 Java 应 用 的 话 ， 那 么 在 build.gradle 的 dependencies 
代码 块 中 需要 添加 如 下 的 依赖 : 





compile("org.springframework.boot:spring-boot-starter-actuator") 


或 者 ， 在 项 目的 Maven pom.xml 文 件 中 ， 我 们 可 以 添加 如 下 的 


<dependencyy>: 


<dependency> 
<groupId> org.springframework.boot</groupId> 


<artifactId>spring-boot-actuator</carlsbad> 
</dependency> 





添加 完 Spring Boot Actuator 之 后 ， 我 们 可 以 重新 构建 并 启动 应 用 ， 然 后 
打开 浏览 器 访问 以 上 所 述 的 端点 来 获取 更 多 人 信息。 例如， 如果 想 要 查看 
Spring 应 用 上 下 文中 所 有 的 bean， 那 么 可 以 访问 
http://localhost:8080/beans。 如 果 使 用 curl 命 令 行 工 具 的 话 ， 所 得 到 的 结 
条 将 会 如 下 所 示 《〈 为 了 便于 阅读 ， 进 行 了 格式 化 和 删 减 ) : 





$ curl http://1ocalhost :8686/beans 
[ 
{ 
"beans": [ 
{ 
"bean": "contactController", 
"dependencies": [ 
"contactRepository" 
]， 
"resource": "null", 
"scope": "singleton", 
"type": "ContactController" 


"bean": "contactRepository", 

"dependencies": [ 
"jdbcTemplate" 

]， 

"resource": "null", 

"scope": "singleton", 

"type": "ContactRepository" 


"bean": "jdbcTemplate", 

"dependencies": []， 

"resource": "class path resource [...]"， 

"scope": "singleton", 

"type": "org.springframework.jdbc.core.JdbcTemplate" 





从 这 里 ， 我 们 可 以 看 到 有 一 个 ID 为 contactController 的 bean， 它 依 
赖 于 名 为 contactRepository 的 bean， 而 contactRepository 又 依赖 
于 jdbcTemp1Latebean。 


因为 我 对 输出 进行 了 删 减 ， 所 以 有 很 多 的 bean 没 有 展现 出 来 ， 它 们 都 包 
含 在 %beans” 端 点 所 产生 的 JSON 中 。 对 于 自动 装配 和 自动 配置 所 形成 的 
神秘 结果 ， 这 里 提供 了 一 种 了 解 内 部 实现 的 手段 。 


另外 一 个 端点 也 能 帮助 我 们 了 解 Spring Boot 自 动 配置 的 内 部 情况 ， 这 就 
是 “/autoconfig”。 这 个 端点 所 返回 的 JSON 摘 述 了 Spring Boot 在 自动 配置 
bean 的 时 候 所 做 出 的 决策 。 例 如 ， 当 针对 Contacts 应 用 调 

用 “autoconfig” 端 点 时 ， 如 下 展现 了 删 减 后 《并 进行 了 格式 化 ) 的 JSON 


二 
结 

















$ curl http://1Localhost:8686/autoconfig 
{ 
"negativeMatches": { 
"AopAutoConfiguration": [ 
{ 

"condition": "OnClassCondition", 

"message": "required @ConditionalOnClass classes not found: 
org.aspectj.1lang.annotation.Aspect, 
org.aspectj.1lang.reflect.Advice" 

} 
] 


2 
atchAutoConfiguration": [ 
{ 
"condition": "OnClassCondition", 
"message": "required @ConditionalOnClass classes not found: 
org.springframework.batch.core.1launch.JobLauncher" 


]， 
2 


"positiveMatches": { 
"ThymeleafAutoConfiguration": [ 
{ 
"condition": "OnClassCondition", 
"message": "@ConditionalOnClass classes found: 
org.thymeleaf.spring4.SpringTemplateEngine" 
} 
]， 
"ThymeleafAutoConfiguration.DefaultTemplateResolverConfiguration":[ 


{ 


"condition": "OnBeanCondition", 
"message": "@ConditionalOnMissingBean 
(names: defaultTemplateResolver; SearchStrategy: all) 
found no beans" 
} 
]， 
"ThymeleafAutoConfiguration.ThymeleafDefaultConfiguration": [ 
{ 
"condition": "OnBeanCondition", 
"message": "@ConditionalOnMissingBean (types : 
org.thymeleaf.spring4.SpringTemplateEngine; 
Searchstrategy: all) found no beans" 


]， 


"ThymeleafAutoConfiguration.ThymeleafViewResolverConfiguration": [ 
{ 
"condition": "OnClassCondition", 
"message": "@ConditionalOnClass classes found: 
javax.servlet.Servlet" 
} 
]， 
"ThymeleafAutoConfiguration.ThymeleafViewResolverConfiguration 
#thymeleafViewResolver": [ 
{ 
"condition": "OnBeanCondition", 
"message": "@ConditionalOnMissingBean (names : 
thymeleafViewResolver; SearchStrategy: all) 
found no beans" 








我 们 可 以 看 到 ， 这 个 报告 包含 了 两 部 分 : 一 部 分 是 没有 匹配 上 的 
(negative matches) ， 男 一 部 分 是 逻 配 上 的 (positive matches) 。 在 没 
有 匹配 的 部 分 中 ， 表 明 没 有 使 用 AOP 和 自动 配置 ， 因 为 在 类 路 径 中 没有 





找到 所 需 的 类 。 在 匹配 上 的 部 分 中 ， 我 们 可 以 看 到 ， 因 为 在 类 路 径 下 找 
到 了 SpringTemplateEngine，Thymeleaf 目 动 配 置 将 会 发 挥 作 用 。 同 
时 还 可 以 看 到 ， 除 非 明确 声明 了 默认 的 模板 解析 器 、 视 图 解析 器 以 及 模 
板 bean 人 否则 的 话 ， 这 些 bean 会 进行 自动 配置 。 另 外 ， 只 有 在 类 路 径 中 能 
够 找到 servlet 类 ， 才 会 自动 配置 默认 的 视图 解析 器 。 


“beans” 和 “autoconfig” 端 点 只 是 Spring Boot Actuator 所 提供 的 观察 应 用 
内 部 状况 的 两 个 样 例 。 在 本 草 中 ， 我 们 没有 足够 的 篇 幅 详 细 讨 论 每 个 端 
点 ， 但 是 我 建议 你 自行 符 试 这 些 端点 ， 以 便 掌 握 Actuator 都 提供 了 哪些 
功能 来 帮助 我 们 了 解 应 用 的 内 部 状况 。 


21.5 小结 


Spring Boot 是 Spring 家 族 中 一 个 令 人 兴 香 的 新 项 目 。Spring 致 力 于 简化 
Java 开 有 发， 而 Spring Boot 致 力 于 让 Spring 本 喘 更 加 简单 。 


Spring Boot 用 了 两 个 技巧 来 消除 Spring 项 目 中 的 样板 式 配 置 : Spring 
Boot Starter 和 自动 配置 。 


一 个 简单 的 Spring Boot Starter 依 赖 能 够 殖 换 掉 Maven 或 Gradle 构 建 中 多 
个 通用 的 依赖 。 例 如 ， 在 项 目 中 添加 Spring Boot Web 依 赖 后， 将 会 引入 
Spring Web 和 Spring MVC 模 块 ， 以 及 Jackson 2 数据 绑 定 模块 。 


自动 配置 充分 利用 了 Spring 4.0 的 条 件 化 配置 特性 ， 能 够 自动 配置 特定 的 
Spring bean， 用 来 启用 某 项 特性 。 例 如 ，Spring Boot 能 够 在 应 用 的 类 路 
径 中 探测 到 Thymeleaf， 然 后 自动 将 Thymeleaf 模 板 配 置 为 Spring MVC 视 
图 的 bean。 


Spring Boot 的 命令 行 接 口 (command-line interface，CLI) 使 用 Groovy 进 
一 步 简化 了 Spring 项 目 。 通 过 在 Groovy 代 码 中 简单 地 引用 Spring 组 件 ， 
CLI 束 能 自动 添加 所 需 的 Starter 依 赖 ( 而 这 义 会 触发 自动 配置 ) 。 除 此 
之 外 ， 通 过 Spring Boot CLI 运 行 时 ， 很 多 的 Spring 类 型 都 不 需要 在 
Groovy 代 人 码 中 显 式 使 用 import 语 句 导 入 。 


最 后 ，Spring Boot Actuator 为 基于 Spring Boot 开 发 的 Web 应 用 提供 了 一 
些 通 用 的 管理 特性 ， 包 括 查 看 线程 dump、Web 请 求 历史 以 及 Spring 应 用 
上 下 文中 的 bean。 


在 读 完 本 章 之 后 ， 你 可 能 会 想 为 什么 要 将 像 Spring Boot 这 样 有 用 的 话题 
放 到 书 的 结尾 呢 。 你 甚至 可 能 会 想 ， 如 果 我 早 一 点 介 绍 Spring Boot 的 
话 ， 那 么 很 多 之 前 所 学 的 内 容 将 会 更 加 简单。 确实 ，Spring Boot 在 
Spring 之 上 提供 了 很 有 意思 的 编程 模型 ， 一 旦 用 上 乞 之 后 ， 很 难 想象 如 
条 没 有 它 的 话 ， 该 如 何 编写 Spring 应 用 。 


我 可 以 说 之 所 以 将 Spring Boot 留 在 最 后 ， 是 因为 想 让 你 对 Spring 有 更 深 
入 的 理解 (反正 对 你 有 好 处 就 是 了 ) 。 尺 管 可 以 这 么 讲 ， 但 真正 的 原因 
是 Spring Boot 推 出 的 时 候 ， 本 书 的 大 部 分 内 容 已 经 写 完 了 。 所 以 我 只 能 











将 其 放 到 一 个 不 影响 整 本 书 的 地 方 : 也 就 是 结尾 
谁 知 道 呢 ? 也 许 在 本 书 的 下 一 版 中 ， 从 一 开始 我 就 会 介绍 Spring Boot。 


[sd 
看 完了 了 
如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@epubit.com.cn， 会 有 编 
辑 或 作 译 者 协助 答疑 。 也 可 访问 异步 社区 ， 参 与 本 书 讨论 。 
如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook(Oepubit.com.cn 。 
在 这 里 可 以 找到 我 们 : 


。 微 博 : @ 人 邮 异 步 社区 
。 QQ 和 群 : 368449889 








